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PREFACE 


This manual is the prime document for the DOS-15 Monitor Software 
System and describes its features, concepts, programming, and opera¬ 
ting procedures. The first four chapters provide a general descrip¬ 
tion of the DOS-15 System components, both hardware and software, 
fundamental system concepts, and file structures. 

The remaining six chapters deal with the DOS-15 system at a more 
technical level. They are primarily concerned with I/O programming 
requirements and techniques under the Monitor, runtime keyboard com¬ 
mands, and operating procedures. The information in these chapters 
is directed primarily to readers who are familiar with either the 
FORTRAN IV language or the PDP-15 assembly language, MACRO-15 (de¬ 
scribed in DEC-15-LFLMA-A-D and DEC-15-LMACA-B-D, respectively). 
FORTRAN users, however, need only be concerned with chapters 7, 8, 
and 10, since FORTRAN I/O considerations are specifically covered 
in the PDP-15 FORTRAN IV Operating Environment manual 
(DEC-15-LFEMA-A-D). 

Detailed information on the internal operations of the DOS-15 Monitor 
and its file structure as well as procedures for preparing user- 
created system software are provided in the DOS-15 System Manual 
(DEC-15-ODFFA-B-D). Brief descriptions of all system programs with 
applicable document numbers are contained in Chapter 2. 

A quick reference summary of the command strings, operating procedures 
and error messages for the Monitor and system programs is provided in 
the DOS-15 Keyboard Command Guide (DEC-15-ODKCA-A-D). 


& 


iii 






CONTENTS 


Page 

CHAPTER 1 DISK OPERATING SYSTEM 

1.1 INTRODUCTION 1-1 

1.1.1 System Features 1-2 

1.2 SYSTEM HARDWARE 1-3 

1.2.1 Minimum Hardware Requirements 1-3 

1.2.2 Optional Hardware 1-5 

1.2.2.1 Unichannel-15 Hardware 1-7 

1.2.2.2 CTRL X Feature 1-8 

1.2.2.3 Real-Time Clock 1-8 

1.2.3 The System Device 1-8 

1.3 SYSTEM SOFTWARE 1-9 

1.3.1 How DOS is Supplied 1-12 

1.3.2 DOS Checkout Package 1-13 

CHAPTER 2 SYSTEM PROGRAMS 

2.1 INTRODUCTION 2-1 

2.2 CHOICE OF LANGUAGES 2-1 

2.2.1 FORTRAN IV Compiler 2-1 

2.2.2 MACRO-15 Assembler 2-2 

2.2.3 MACH Assembler 2-4 

2.2.4 FOCAL Interpreter 2-5 

2.3 SYSTEM GENERATOR (SGEN) 2-6 

2.4 PATCH UTILITY PROGRAM 2-7 

2.5 CHAIN AND EXECUTE PROGRAMS 2-8 

2.5.1 Advantages/Disadvantages of CHAIN & 

EXECUTE 2-9 

2.5.1.1 Advantages 2-9 

2.5.1.2 Disadvantages 2-9 

2.6 LINKING LOADER 2-9 

2.7 DYNAMIC DEBUGGING TECHNIQUE (DDT) PROGRAM 2-10 

2.8 DUMP PROGRAM 2-10 

2.9 MAGNETIC TAPE DUMP (MTDUMP) UTILITY 

PROGRAM 2-11 

2.10 TEXT EDITOR PROGRAMS, EDIT, EDITVP AND 

EDITVT 2-11 

2.11 PERIPHERAL INTERCHANGE PROGRAM (PIP) 2-11 

2.12 DECTAPE COPY (DTCOPY) 2-12 

2.13 LIBRARY UPDATE PROGRAM 2-12 

2.14 SOURCE COMPARE PROGRAM (SRCCOM) 2-12 

2.15 GRAPHIC-15 - 2-12 


v 



Page 


2.16 

PDP-8 TO PDP-15 TRANSLATOR (8TRAN) 

2-13 

2.17 

PDP-8 TO PDP-9 TRANSLATOR (89TRAN) 

2-13 

2.18 

VP15A GRAPHICS SOFTWARE 

2-13 

CHAPTER 3 

SYSTEM CONCEPTS 


3.1 

DOS-15 MONITORING FUNCTIONS 

3-1 

3.1.1 

System Communication Table (SCOM) 

3-2 

3.1.2 

Monitor/User Interaction 

3-3 

3.2 

I/O COMMUNICATION 

3-4 

3.2.1 

Device Independence 

3-4 

3.2.2 

I/O Device Handlers 

3-5 

3.2.3 

Device Assignment Table (.DAT) 

3-5 

3.3 

FILE STRUCTURES 

3-5 

3.3.1 

User File Directories and UIC's 

3-6 

3.3.2 

Monitor Identification Code (MIC) 

3-6 

3.4 

FILE PROTECTION 

3-7 

3.5 

I/O BUFFERS 

3-7 

3.6 

CHOICE OF EXECUTABLE FORM 

3-7 

3.6.1 

Relocatable Binary 

3-7 

3.6.2 

Absolute Binary Forms 

3-8 

3.6.2.1 

.ABS and .ABSP Binary 

3-8 

3.6.2.2 

.FULL and .FULLP Binary 

3-8 

3.7 

LOADER CONTROL 

3-8 

3.7.1 

Globals 

3-9 

3.7.2 

Program Loading 

3-9 

3.7.2.1 

Page Mode Operation 

3-9 

3.7.2.2 

Bank Mode Operation 

3-9 

3.8 

ERROR DETECTION 

3-10 

3.9 

INPUT/OUTPUT SPOOLING 

3-11 

CHAPTER 4 

FILE STRUCTURES 


4.1 

INTRODUCTION 

4-1 

4.2 

DEVICE ASSIGNMENTS 

4-1 

4.3 

FILES 

4-2 

4.3.1 

Records 

4-2 

4.3.2 

Words 

4-2 

4.3.3 

Data Modes 

4-3 

4.4 

FILE STRUCTURES 

4-3 

4.4.1 

File and Data Access Techniques 

4-4 

4.4.2 

Sequential Access 

4-4 

4.4.3 

Direct Access 

4-4 

4.5 

MAGNETIC TAPE FILE STRUCTURE 

4-5 

4.6 

DECTAPE FILE STRUCTURE 

4-6 



"-"TV 


■' 'T \ 






vi 




4.7 

DISK FILE STRUCTURE 

4-8 

4.7.1 

User Identification Codes (UIC) 

4-8 

4.7.2 

The User File Directory Table (.UFDT) 

4-9 

4.7.3 

File Protection 

4-9 

4 i 7.4 

Organization of Specific Files on Disk 

4-11 

4.7.5 

The Disk Handlers 

4-11 

CHAPTER 5 

DOS SYSTEM MACROS 


5.1 

INTRODUCTION 

5-1 

5.2 

MONITOR-PROCESSED COMMANDS 

5-1 

5.2.1 

Summary of DOS Monitor System Macros 

5-1 

5.2.2 

DOS-15 System Macro Expansions 

5-2 

5.2.2.1 

.PUT 

5-3 

5.2.2.2 

.GET 

5-4 

5.2.2.3 

.GTBUF (Get Buffer) 

5-5 

5.2.2.4 

.GVBUF (Give Buffer) 

5-5 

5.2.2.5 

.OVRLA 

5-6 

5.2.2.6 

.EXIT 

5-6 

5.2.2.7 

.TIMER 

5-7 

CHAPTER 6 

Programmed i/o commands 


6.1 

INTRODUCTION ' / 

6-1 

6.2 

GENERAL I/O COMMUNICATIONS 

6-1 

6.2.1 

.READ/.WRITE/.RTRAN Operations 

6-3 

6.2.2 

.TRAN Operations 

6-3 

6.3 

SEQUENTIAL FILE PROCESSING 

6-3 

6.3.1 

Logical Record Format, IOPS 

6-3 

6.3.1.1 

Header Word Pair Format 

6-4 

6.3.1 „ 2 

Using the Header Word Pair 

6-4 

6.4 

DATA MODES 

6-6 

6.4.1 

IOPS Modes 

6-7 

6.4.1.1 

IOPS ASCII 

6-7 

6 ® 4.1.2 

IOPS Binary 

6-9 

6.4.2 

Image Modes 

6-10 

6.4.3 

Dump Mode 

6-12 

6.4.4 

Logical Record Terminators 

6-12 

6.5 

I/O BUFFERS 

6-14 

6.5.1 

Space Allocation 

6-14 

6.5.2 

Size Considerations 

6-14 

6.6 

SPECIFYING I/O DEVICES 

6-16 

6.7 

I/O MACRO DESCRIPTIONS 

6-16 

6.7.1 

.CLEAR 

6-17 

6.7.2 

.CLOSE 

6-17 

6.7.3 

.DLETE 

6-18 

6.7.4 

.ENTER 

6-18 

6.7.5 

.FSTAT 

6-19 

6.7.6 

. IN IT 

6-20 

6.7.7 

.MTAPE 

6-21 

6.7.8 

.RAND 

6-21 

6.7.9 

.READ 

6-22 



Page 


6 

6 

6 

6 

6 

6 

6 

6 

6 
6 
6 , 
6 
6 , 
6, 
6 . 

CHAPTER 7 

7 . 

7. 

7. 
7» 
7. 
7 o 
7 . 
7. 
7. 
7. 
7, 

7 . 

7. 

CHAPTER 8 

8 . 

8. 
8. 
8. 
8 . 

8 o 
8 . 
8. 
8. 

8.< 
8.' 
8. ' 
8.i 
8 .- 

8.! 

8.J 
8 .! 
8.! 


7.10 

.RENAM 

6-23 

7.11 

.RTRAN 

6-23 

7.12 

.SEEK 

6-24 

7.13 

.TRAN 

6-25 

7.14 

.USER 

6-26 

7.15 

.WAIT 

6-27 

7.16 

.WAITR 

6-27 

7.17 

.WRITE 

6-28 

8 

USING I/O MACROS 

6-29 

8.1 

Physical Device Capabilities 

6-29 

8.2 

Device Handler Characteristics 

6-29 

8.3 

I/O Macro Syntax 

6-29 

8.4 

Selecting an I/O Macro Sequence 

6-31 

8.5 

Programming Example 

6-33 

8.6 

File Integrity Considerations 

SYSTEM INITIALIZATION 

6-44 

1 

INTRODUCTION 

7-1 

2 

HOW THE SYSTEM SOFTWARE IS SUPPLIED 

7-1 

3 

SYSTEM STARTUP PROCEDURES 

7-3 

3.1 

Disk Restoration (DOSSAV) 

7-3 

3.1.1 

Operating Procedures 

7-4 

3.1.2 

Commands 

7-5 

3.1.3 

Examples of DOSSAV Commands 

7-7 

3.1.4 

Error Messages and Meanings 

7-10 

3.1.5 

Restart Procedures 

7-11 

3.2 

Loading and Starting the Monitor 

7-11 

3.2.1 

Loading the Bootstrap 

7-12 

3.2.2 

Bootstrap Restart Procedures 

7-12 

4 

SYSTEM MODIFICATION (TAILORING) PROCEDURES 

KEYBOARD COMMANDS 

7-13 

L 

INTRODUCTION 

8-1 


KEYBOARD COMMAND FORMATS AND CHARACTERS 

8-2 

>.l 

Keyboard Command Elements 

8-2 

. 2 

Editing Features 

8-2 

>.3 

When to Issue Keyboard Commands 

8-3 


COMMANDS TO REQUEST SYSTEM INFORMATION 

8-3 

5.1 

SCOM 

8-3 

5.2 

INSTRUCT 

8-7 

5.3 

REQUEST 

8-13 


COMMANDS RELATED TO FILE PROTECTION 

8-13 

.1 

LOGIN 

8-13 

.2 

MICLOG 

8-14 

.3 

PROTECT 

8-14 

.4 

LOGOUT 

COMMANDS DEALING WITH I/O DEVICE 

8-14 


ASSIGNMENTS 

8-15 

.1 

REQUEST 

8-15 

.2 

ASSIGN 

8-17 

.3 

KEEP ON/OFF 

8-18 


vm 






Page 

8.6, 

CORE ALLOCATION COMMANDS 

8-18 

8.6.1 

BUFFS 

8-18 

8.6.2 

X4K ON/OFF 

8-19 

8.7 

CORE IMAGE SAVE/RESTORE COMMANDS 

8-19 

8.7.1 

CTRL Q 

8-20 

8.7.2 

QDUMP 

8-20 

8.7.3 

PUT 

8-20 

8.7.4 

GET 

8-21 

8.8 

VT15 DISPLAY COMMANDS 

8-22 

8.8.1 

Operating Features 

8-22 

8.8.1.1 

Display Modes 

8-22 

8.8.1.2 

Clearing the Display Screen 

8-23 

8.8.1.3 

Editing 

8-23 

8.8.2 

Display Command Descriptions 

8-23 

8.8.2.1 

VT ON/OFF 

8-23 

8.8.2.2 

HALF ON/OFF 

8-24 

8o8.2.3 

CTRL X 

8-24 

8.8.2.4 

Command Default Settings 

8-24 

8.9 

MISCELLANEOUS COMMANDS 

8-24 

8.9.1 

API ON/OFF 

8-24 

8.9.2 

33TTY ON/OFF and LA30 ON/OFF 

8-25 

8.9.3 

CHANNEL 7/9 

8-25 

8.9.4 

LP ON/OFF 

8-25 

8.9.5 

BANK ON/OFF - PAGE ON/OFF 

8-25 

8.9.6 

DATE 

8-26 

8.9.7 

TIME 

8-26 

8.9.8 

TIMEST 

8-27 

8.9.9 

LOG 

8-27 

8.9.10 

HALT 

8-27 

8.9.11 

CTRL D 

8-27 

8.10 

SYSTEM PROGRAM LOADING COMMANDS 

8-28 

8.11 

PROGRAM START/RESTART/CONTINUE COMMANDS 

8-28 

8.11.1 

CTRL C 

8-28 

8.11.2 

CTRL P 

8-29 

8.11.3 

CTRL S 

8-30 

8.11.4 

CTRL T 

8-30 

8.11.5 

CTRL R 

8-30 

8.12 

BATCHING KEYBOARD COMMANDS 

8-30 

8.12.1 

Preparation 

8-30 

8.12.2 

Operator Commands 

8-31 

8.12.2.2 

CTRL T 

8-31 

8.12.2.3 

CTRL C 

8-31 

8.12.2.4 

CTRL R 

8-31 

8.12.3 

Job Control Commands 

8-31 

8.12.3.1 

$ JOB 

8-31 

8.12.3.2 

$DATA 

8-32 

8.12.3.3 

$END 

8-32 

8.12.3.4 

$PAUSE 

8-32 

8.12.3.5 

$EXIT 

8-32 

8.12.4 

Restrictions 

8-32 

8.13 

KEYBOARD ERROR DETECTION AND HANDLING 

8-33 



IX 



9 

I/O DEVICE HANDLERS 

9.1 

INTRODUCTION 

9.2 

DEVICE HANDLERS ACCEPTABLE TO SYSTEM 
PROGRAMS 

9.2.1 

FORTRAN IV (F4) 

9.2.2 

MACRO-15 

9.2.3 

MACll 

9.2.4 

FOCAL 

9.2.5 

EDIT, EDITVP, and EDITVT 

9.2.6 

Linking Loader and DDT 

9.2.7 

PIP (Peripheral Interchange Program) 

9.2.8 

SGEN (System Generator) 

9.2.9 

PATCH 

9.2.10 

UPDATE 

9.2.11 

DUMP 

9.2.12 

CHAIN 

9.2.13 

EXECUTE 

9.2.14 

SRCCOM (Source Compare) 

9.2.15 

DTCOPY (DECtape Copy) 

9.2.16 

8TRAN (PDP8 to PDP-15 Translator) 

89TRAN (PDP-8 to PDP-9 Translator) 

9.2.17 

MTDUMP (Magtape User’s Utility Program) 

9.2.18 

SPOOL 


9.3 

9.3.1 

9 . 3 . 1 . 1 

9.3.1.2 

9.3.1.3 
9.3.2 

9.3.2.1 

9.3.2.2 

9.3.3 

9.3.4 

9.3.4.1 

9.3.4.2 

9.3.5 


9.3.5.1 

9.3.5.2 
9.3.6 

9.3.6.1 

9 . 3.6 • 2 

9.3.7 

9.3.7.1 

9.3.7.2 

9.3.8 

9.3.8.1 

9.3.8.2 

9.3.9 

9.3.10 


I/O HANDLER DESCRIPTIONS 
Teleprinter Handler (TTA) 

General Description 

Device Dependent Characteristics 

Program Control Characters 

Paper Tape Punch Handlers (PPA, PPB, and 

PPC) 

General Description 
Device Dependent Characteristics 
Paper Tape Reader Handlers (PRA and PRB) 
DECtape Handlers (DTA, DTC, DTD, DTE, 
and DTF) 

General Description 
Device Dependent Characteristics 
DECdisk, Disk Cartridge and' Disk Pack 
Handlers (DKA/RKA/DPA, DKB/RKB/DPB, 
and DKC/RKC/DPC) 

General Description 

Device Dependent Characteristics 

Magtape Handlers (MTA, MTC, and MTF) 

General Description 

Device Dependent Characteristics 

Line Printer Handler (LPA) 

General Description 

Device Dependent Characteristics 

Card Reader Handler (CDB) 

General Description 

Device Dependent Characteristics 

VP15A Storage Tube Display (VPA) 

UC15 XY11 PLOTTER (XYA) 


9-1 


9-2 

9-3 

9-4 

9-4 

9-5 

9-6 

9-6 

9-7 

9-7 

9-8 

9-8 

9-8 

9-9 

9-9 

9-9 

9-10 

9-10 

9-11 

9-11 

9-11 

9-12 

9-12 

9-12 

9-14 

9-15 

9-15 

9-16 

9-16 

9-18 

9-18 

9-19 


9-19 

9-19 

9-21 

9-24 

9-24 

9-26 

9-26 

9-26 

9-27 

9-28 

9-28 

9-29 

9-30 

9-32 



CHAPTER 10 

OPERATING PROCEDURES 


10.1 

INTRODUCTION 

10-1 

10.2 

EXAMPLE OF KEYBOARD OPERATIONS 

10-1 

10.3 

EXAMPLE OF OPERATING PROCEDURES USING 
COMMAND BATCHING MODE 

10-9 

10.4 

ERROR DETECTION AND RECOVERY PROCEDURES 

10-14 

APPENDIX A 

PDP-15 IOPS ASCII STANDARD CHARACTER SET 

A—1 

APPENDIX B 

SAMPLE IOPS ASCII PACKING AND UNPACKING 
ROUTINES 

B-l 

APPENDIX C 

INPUT/OUTPUT DATA MODE TERMINATORS FOR 
SPECIFIC DEVICE HANDLERS 

C-l 

APPENDIX D 

IOPS ERROR CODES 

D-l 

APPENDIX E 

LINKING LOADER AND SYSTEM LOADER ERRORS 

E-l 

APPENDIX F 

PDP-15 ASCII/HOLLERITH CORRESPONDENCE 

F—1 

APPENDIX G 

DOS-15 CHECKOUT PROCEDURES 

G-l 

APPENDIX H 

DOS TERMS AND ACRONYMS 

H-l 

APPENDIX I 

UC15 SPOOLER ERROR MESSAGES 

1-1 

APPENDIX J 

UC15 SYSTEM ERROR MESSAGES 

J-l 




XI 





CHAPTER 1 

DISK OPERATING SYSTEM 


1.1 INTRODUCTION 

The PDP-15 Disk Operating System (DOS-15) is an integrated set of 
software designed to meet the demands of research, engineering, 
and industrial environments. It includes the software necessary 
for simplified programming and efficient operations. DOS-15 
brings to the user the advantages of disk resident storage via 
rapid access to the system's resources. The operating system 
runs with a PDP-15/20 Central Processor having at least 16,384 
18—bit words of main memory and the specific capabilities required 
by the system (see Paragraph 1.2, "System Hardware"). 

The System Monitor is an integrated set of commonly-used programs 
for the development of user applications. These programs include 
tools for: 

Program Preparation, 

Compilation, 

Assembly,. 

Debugging, and 

Execution of User Programs. 

The DOS Monitor, the heart of the system, incorporates all the func¬ 
tions of the "Advanced Monitor System" plus the added power of 
fully automatic random access file operation. The user controls 
the operating system by instructions to the Monitor. The Monitor 
runs the jobs, supervises data and file manipulation, and interacts 
with the operator/user in a simple, conversational manner. 

In the operating system, data on mass storage is handled by macro 
statements used with the MACRO-15 symbolic assembler language, and 
by the mass storage language elements incorporated into the FORTRAN 
IV compiler. 


1-1 



1.1.1 System Features 


Disk Resident 
System Software 


Interactive 

Operation 


I/O Device 
Handlers 


Programmed 

Monitor 

Commands 


Conversational 

Mode 


Dynamic Storage 
Allocation 

Dynamic Buffer 
Allocation 


Disk File 
Structure 


All DOS-15 System Software resides on either 
DECdisk, Disk Pack, or Disk Cartridge* 

An interactive keyboard/program Monitor permits 
device-independent programming and automatic 
calling and loading of system and user programs. 

Data and file manipulating I/O device handlers 
are supplied for standard system peripherals. 

Input/Output programming is simplified by the 
use of a set of system commands which are 
standardized for system-supported I/O devices. 

System Utility Programs interact with the operator/ 
user in a simple, conversational manner. 

The available disk storage is automatically allo¬ 
cated for optimum storage utilization. 

Input/Output core is automatically optimized by 
the Monitor. It allocates only that space which 
is required for the system and the user. 

Allows the most efficient use of disk capacity 
and data retrieval for processing via: 

• System supported DECdisk, Disk Cartridge 

and Disk Pack devices, providing both 
economy and storage capacity 

® Virtually unlimited data capacity (Disk 

Pack - 83„7 million words, DECdisk - 2„09 
million words. Disk Cartridge - 10 million words) 

• Random/Sequential File access 

® File Protection through unique user 

directories 




User-Created 
System Files 


I/O Spooling 

Programming 

Languages 


Bank and Page 
Modes 


® User/user file independence - identically 
named unformatted Input/Output (FORTRAN-IV) 

® Random Access - formatted as well as unfor¬ 
matted Input/Output (FORTRAN-IV) 

The user may easily incorporate his own software 
into the operating system, thereby tailoring the 
system to his hardware and software needs. 

Line Printer, card reader, and XY plotter spooling 
is available on Unichannel-15 systems. 

Several programming languages are offered: 

FORTRAN IV, FOCAL, MACRO-15 and MACRO-11 on Uni¬ 
channel-15 systems. 

Choice of 8K (Bank Mode) or 4K (Page Mode) direct 
addresability. Bank Mode permits DOS-15 operation 
on the PDP-9. 


The system provides for several levels of user file protection. Using 
unique User Identification Codes, each user can be assured of his file 
integrity. Files are protected and invisible to other users. The 
system provides privileged access to all files via a supervisory code 
maintained by the system owner or manager. 

1.2 SYSTEM HARDWARE 

The Disk Operating System is defined within the limits of a particular 
PDP-15 hardware system configuration? i.e., central processor model, 
minimum and maximum core requirements, necessary features, and types 
and numbers of peripheral devices. 

The system software is distributed as a Disk Restore System on DECtape, 
or Magtape, and operates from DECdisk, Disk Pack, or Disk Cartridge 
with DECtape or Magtape backup storage. 

1.2.1 Minimum Hardware Requirements 

The minimum equipment configuration for the DOS-15 software includes 
the PDP-15 Central Processor with the following features: 

16,384 18-bit words of core memory 
35 Teleprinter 

PC15 High-speed Paper Tape Reader and Punch 
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KE15 Extended Arithmetic Element 
TC15 DECtape Contrdl 

1 TU56 Dual DECtape Transport or 2 TU55 DECtape Transports 
or 

TC59 Magtape Control 

1 TU10, TU20, or TU30 Magnetic Tape Transport (7- or 9-track) 
RF15 DECdisk Control 

1 RS09 DECdisk Drive (262,144 words) 
or 

RP15 Disk Pack Control 

1 RP02 Disk Pack Drive (10.24 million words) 

1 RP02D Disk Pack 
or 

an RK15 Cartridge Disk system comprised of; 

an RKllE disk control with 1 RK05 drive (1.2 million words) 

+ a UNICHANNEL-15 peripheral processor with 4096 words of 
16 bit core memory. 

The PDP-15 hardware environment is illustrated in Figure 1-1.* 


A UC15 system requires the KW15 real time clock facility on the PDP-15. 
KA15 Automatic Priority Interrupt is also required on the PDP-15 if 
one has a PDP-11 hardware option which needs to interrupt the PDP-15 
and is not one of the following; RK05, CR11, XY11, LP11, LS11 or 



MEMORY BANKS 



---OPTIONAL SUBSYSTEMS 


1 / ~ s 

8 ' 
V ^ 


Figure 1-1 Hardware Environment 


1.2.2 Optional Hardware 


Additional hardware supported by the operating system is as follows; 

up to 32,768 18-bit words of core memory 

KA15 Automatic Priority Interrupt 

KW15 Real Time Clock 

FP15 Floating Point Processor 

35 and/or 33 Teleprinter or LA30C DECwriter 

PC15 High Speed Paper Tape Reader and Punch 

TC15 DECtape Control 

4 TU56 Dual or 8 TU55 DECtape Transports 
RF15 DECdisk Control 

8 RS09 DECdisk Drives (262,144 words per drive) 

RP15 Disk Pack Control 

8 RP02 Disk Pack Drives (10,240,000 words per drive) 
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*RK15 Disk Cartridge Control 

8 RK05 Disk Cartridge Drives (1.25 million words per 
drive) 

TC59 Magtape Control 

8 TU10, TU20 or TU30 (7- or 9-track) Tape Transports 
Card Readers 

CR03B 200 cpm Reader and Control 
or 

CR15 1000 cpm Reader and Control 
or 

*CR11 300 cpm Reader and Control 
VP15 Point Plotting Displays 
VT15 Graphic Display Processor 

VT04 Graphic Display Console 
or 

VT07 Graphic Display Console 
LK35 Keyboard 
Line Printers 

LP15 - 1000 1pm, 132 column line 
or 

- 356 1pm, 80 or 132 column line 
or 

*LP11- 245 1pm, 64 character 

set /173 1pm, 96 character 
set 132 column lines 
or 

- 356 1pm, 64 character 

set /253 1pm, 96 character 
set 80 column line 
or 

*LS11- 130 1pm, 132 column line 
VWA Writing Tablet 
Plotters* 

XY11 - .005 in. Step increments at 300 steps/sec. 









*For UC15 systems only 
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1.2.2.1 Unichannel-15 Hardware 


The UC15 System, in its standard configuration, consists of the follow 
ing equipment: 

PDP-11 programmable controller 
DR15-C Device Interface 
Two DR11-C Device Interfaces 
MX15-B Memory Multiplexer 

Local memory - up to 12,288 16 bit words of core memory 

NOTE 

The PDP-11, which functions as the 
programmable controller, can itself 
only process 16-bit words but con¬ 
trols peripherals that can process 
18-bit words to provide compatibility 
with the PDP-15. 

The DR15-C and the two DR11-C Device Interfaces provide a communica¬ 
tion facility between the PDP-15 and the PDP-11. In the normal mode 
of operation the PDP—15 interrupts the PDP-11 to send to it commands 
and data. The PDP-11 processes the commands, accepts the data, and 
when done, interrupts the PDP-15 to indicate job completion and possi¬ 
ble error conditions. 

. .. ^ t . .. .... .; .. i . . , 

The MX15-B Memory Multiplexer functions as a memory bus switch to 
allow either the PDP—15 or the PDP-11 to communicate with the common 
memory. 

The following illustration shows the UC15 hardware configuration. 
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Figure 1-2 Unichannel-15 Hardware 


1.2.2.2 CTRL X Feature - The Control X feature is available to the 
user whose system configuration includes a VT15 Display Processor or 
a VT04 Display Console. This feature gives the capability of changing 
from the hard copy output of the teleprinter to the soft copy output 
of the VT15 Display. 

1 „ 2 „ 2.3 Real-Time Clock * - The Real-Time Clock (on systems having 
this option) runs continuously, in order to update an elapsed time 
register. It can be used by the user to time jobs or to control 
program execution. 

In addition to the above, the user may adapt the system to incorporate 
many other specialized peripherals, such as X-Y plotter, data acquisi¬ 
tion equipment, etc. 

1.2.3 The System Device 

The system device for DOS-15 may be the RP15 DECdisk, the RK15 Disk 
Cartridge, or the RP02 Disk Pack. 

The RF15 DECdisk equipment is composed of up to eight fixed-head, 
rotating disks which are treated by DOS as one contiguous storage 
area. The DOS Monitor provides for simultaneous use of the DECdisk 
or Disk Cartridge or Disk Pack as a system device, file device, and 
scratch device. 


*For UC15 systems this is a requirement. 
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1.3 SYSTEM SOFTWARE 


The PDP-15 Disk Operating System's service routines perform four pri¬ 
mary tasks for all user applications (see Figure 1-3). 

1. Run-Time Aids - External routines from several libraries are 
available to the user. The libraries may contain either 
user-designed routines or those provided by DOS-15 which can 
be implicitly or explicitly called. 

2. Utilities - DOS-15 provides facilities for efficient storage, 
flow, and retrieval of system and user data. There are also 
system programs that provide file verification and data buf¬ 
fer allocation, file data manipulation, etc. 

3. Program Preparation and Maintenance - There are 
system programs to aid user program preparation by 
preparing file text for source programs and programs 
to aid testing and maintenance of object programs. 

4. Language Assembly and Compilation - Programs are 
available to translate problem-oriented and procedure 
oriented languages into machine language and to 
incorporate routines into complete, executable programs. 

The system software lets the user deal with many complex problems in 
a simple and straightforward manner. The system will allow the 
user to perform all of these functions; 

1. Write programs in three/four 1 higher-level languages - 
FORTRAN IV, FOCAL, MACRO-11 and MACRO-15. 

2. Edit and debug the program prior to run. 

3. Load and link programs. 

4. Run the program by; 

a. handling I/O, 

b. reading and writing named random-access files 
on disk storage, 

c. providing run-time device independence, 

d. chaining long programs. 

5. Batch process from paper tape or cards. 

6. Support full spooling of the supported devices on the UNIBUS 2 


x For UC15 system only. 

2 Requires at least 8K of local memory on the PDP-11. 
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Figure 1-3 

PDP-15 Monitor Disk Operating System Software 


'For UC15 systems only. 

For RK05/RK15 based UC15 systems only* 
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Listed in Table 1-1 are individual system programs in the PDP-15 
Disk Operating System. 


Table 1-1 DOS System Software 


System Functions 

Program Name 

Description 

MONITORS 

DOS-15 Monitor 

Allows system parameter 
changes and device as¬ 
signments 


PIREX 1 

A multi-tasking, multi¬ 
programming executive that 
runs in the PDP-11 local 
memory . 

LANGUAGES 

FORTRAN IV 

Compiler, Object Time 

System, Science Library. 


FOCAL 

An on-line interactive 
algebraic language,, 


MACRO-15 

A symbolic PDP-15 assembler 
language 


MAC-11 1 

A symbolic PDP-11 assembler 
language. 

PREPARATION AND 

DDT 

A Dynamic Debugging Tech- 

DEBUGGING 


nique for FORTRAN and 

MACRO programs. 




DUMP 

The capability to output 
specified core locations. 


EDIT 

Text Editor providing 
insertion, deletion, and 
modification of symbolic 
text. 


EDITVP & EDITVT ; 

Special versions of EDIT 
which provide fast soft 
copy editing on the VT or 

VP display system. 

UTILITIES 



General 

PIP 

Facilitates the manipula- 



tion and transfer of a 
data file from any input 
to any output device. 


DTCOPY 

High-speed DECtape copy 
program. 


UPDATE 

Binary program retrieval 
and library update program. 


SRCCOM 

Source compare program. 


MTDUMP 

Magnetic Tape DUMP program. 


8TRAN 

Translates PDP-8 source 
code into PDP-15 code. 


89TRAN 

Translates PDP-8 source 
code into PDP-9 code. 


1 For UC15 system only. 












Table 1-1 DOS System Software (Cont'd) 


System Functions 

1 Program Name 

| Description 

UTILITIES 



System 

SGEN 

Provides the ability to 
tailor the system struc¬ 
ture to a particular hard¬ 
ware/software configuration. 


PATCH 

Makes corrections to sys¬ 
tems programs on the systems 
device, and adds programs 
to the system. 


SPOOL 1 

Permits automatic temporary 
storage of low speed data 
on a high speed storage 
device. 

OPERATING PROGRAMS 

Linking Loader 

Loads relocatable programs 



and required routines. 


CHAIN & EXECUTE 

Multiple segmentation of 
large programs and overlays 
to allow economy of core. 


These programs are supervised by the Monitor to form an interactive 
collection of service programs. This relationship is illustrated in 
Figure 1-3. 


1.3.1 How DOS is Supplied 


General purpose software is supplied to the PDP-15 user on two/eight 2 
DECtapes or one 7- or 9-track magnetic tape as a disk-restore initial¬ 
ization. The DOS-15 System tape(s) contain all of the standard 
PDP-15 DOS System Programs, Utility Programs, and I/O Device Handlers 
supplied and supported by Digital Equipment Corporation. An unmodified 
master system tape or tapes should be maintained as a reference back¬ 
up system. Users with the FP-15 Floating Point hardware are provided 
with additional FP-15 routines on DECtape or Magtape, and users with 
RF or RP based DOS-15 systems with the UC15 option are provided with 
additional software. 


x For RK05/RK15 based UC15 systems only 
2 Unichannel-15 systems only. 
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1.3.2 DOS Checkout Package 


Digital Equipment Corporation supplies a checkout package for 
DOS-15 which allows the user to test the System software for proper 
installation on DECdisk, Disk Pack or Disk Cartridge. The package 
is available on batch paper tapes as follows: 

RF.CHK For the RF15 DECdisk system 
RP.CHK For the RP02 Disk Pack system 

RK.CHK For the RK05 Disk Cartridge system 

These programs provide the user with the ability to briefly test all 
the basic system software supplied for DOS-15. For more information, 
refer to Appendix G, DOS-15 Checkout Package. 






CHAPTER 2 


SYSTEM PROGRAMS 

2.1 INTRODUCTION 

This chapter gives information necessary for the System's Manager and 
Analyst to evaluate system programs to be run under DOS-15 control. 
Each system program will assist the user in performing a particular 
task in the process of application design and implementation. Con¬ 
siderations for system modification are reserved for DOS System Manual 
DEC-15-0DFFA-B-D. 

2 .2 CHOICE OF LANGUAGES 

User source programs can be implemented at several levels depending 
on those particular system features required for a given processing 
environment. DOS-15 supports three levels of automation for object 
program preparation: 

1- Compiler level language - FORTRAN IV 

2. Assembly language - MACRO-15/MAC11 1 

3. Interpretive language - FOCAL 

2.2. 1 FORTRAN IV Compiler 

The PDP-15 FORTRAN IV compiler is a higher-level, procedure-oriented 
language system that accepts statements written in the FORTRAN IV 
language and produces a relocatable object program capable of being 
loaded by the Linking Loader. All versions of PDP-15 FORTRAN IV 
are based on the language of USASI Standard FORTRAN (X3.9-1966). The 
system is augmented by the .Floating Point Processor, the FORTRAN IV 
compiler, and an Object Time System. 

Object time program capabilities include "floating point" instructions. 
Subroutines written in either FORTRAN IV or MACRO-15 assembly language 
can be loaded with and called by FORTRAN IV main programs. Compre¬ 
hensive source language diagnostics are produced during compilation, 
and a symbol table is generated for use in on-line debugging with DDT. 


J For UC15 systems only. 
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The system's Data-Directed Input-Output package permits input or out¬ 
put of ASCII data without reference to a FORMAT statement. The 
system can also perform memory-to-memory transfers (Encode/Decode) 
moving data from memory to the I/O Buffer to memory. 

There are three versions of the FORTRAN IV supported by DOS-15: 

(11 F4X (PDP-15 mode); (2) F4X9 (BANK mode); and (3) FPF4X (Floating 
Point mode). Each version has its own Object Time System and Science 
Library so that program routines may utilize all system hardware and 
software features. 

A FORTRAN IV program may be compiled and run in several different equip¬ 
ment environments. The FORTRAN programmer need not be too concerned 
with the details of his environment since the FORTRAN Object-Time Sys¬ 
tem (OTS) will ensure that his source statements generate the appropri¬ 
ate computer instructions. For example, an arithmetic statement such 
as A=A*B will appear the same in any FORTRAN IV program. in the object 
program it may be transformed to a subroutine call or a floating point 
instruction, depending on the hardware configuration on which the pro¬ 
gram is produced. FORTRAN data-transmission statements automatically 
call a number of OTS subroutines which serve as an interface between 
the user program and the Monitor. These routines may also be called from 
MACRO-15 assembly language programs. Further, programs written in 
FORTRAN IV can be linked to programs or routines written in.the MACRO-15 
assembly language. 

For more information concerning this higher-level programming language, 
refer to the FORTRAN IV Language Manual (DEC-15-LFLMA-A-D) and the 
FORTRAN IV Operating Environment Manual (DEC-15-LFEMA-A-D). 

2.2.2 MACRO-15 Assembler 

This MACRO Assembler provides users with highly sophisticated macro | 
generating and calling facilities within the context of a symbolic as¬ 
sembler. Some of the prominent features of MACRO-15 include: 

1. The ability to: 

(a) define macros, 

(b) define macros within macros (nesting), 

(c) redefine macros (in or out of macro definitions) , 

(d) call macros within macro definitions, 

(e) have macros call themselves (recursion) 

(f) combine up to three input files for one assembly. 
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2 . 


Conditional assembly based on the computational results 
of symbols or expressions. 

3. Repeat functions. 

4. Boolean manipulation. 

5. Optional octal, symbolic,, and cross-reference listings. 

6. Two forms of radix control (octal, decimal) and two 
text modes (ASCII and 6-bit trimmed ASCII). 

7. Global symbols for easy linking of separately assembled 
programs. 

8. Choice of output format: relocatable, absolute binary 
(checksummed), or full binary — capable of being loaded 
via the hardware READIN switch. 

9. Ability to utilize user-designed input/output macros. 

10. A Table of Contents option containing the page numbers 
and text of all assembled .TITLE statements in the 
program. 

MACRO-15 permits the programmer to use mnemonic symbols to represent 
instruction operation codes, locations, and numeric quantities. It 
is essentially a comprehensive macro instruction generator. This 
generator permits easy handling of recursive instruction sequences, 
changing only the arguments. „ 

The assembler facilitates the development of instructions called 
"macros" which, when used as a source statement, can cause a specific 
sequence of instructions to be generated in the object program. 

Refer to the PDP-15 MACRO-15 Assembler Manual , DEC-15-LMACA-B-D, for a 
complete description of the language. 

The standard object code produced by MACRO-15 is in a relocatable format 
which is acceptable to the Disk Operating System's Linking Loader 
utility program. Relocatable programs that are assembled separately 
and use identical global symbols 1 where applicable, can be combined by 
the Linking Loader into an executable program. 

An output listing, showing both the programmer's source coding and the 
binary object program produced by MACRO-15, is printed if desired. 

Symbols which are referenced in one program and defined in another. 
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This listing includes all the symbols used by the programmer with 
their assigned values. If assembly errors are detected, erroneous 
lines are marked with specific letter error codes. 

2.2.3 MAC11 Assembler 1 

This MACRO Assembler (MACH) provides the user of the UNICHANNEL-15 
system with the capability of assembling the full repertoire of the 
PDP-11/20 instruction set. Besides making, the UC15 system self- 
sufficient it provides the users with highly sophisticated macro 
operating and calling facilities within the context of a symbolic 
assembler. Some notable features of MAC11 are: 

1. The ability to: 

(a) define macros, 

(b) define macros within macros (nesting), 

(c) redefine macros (in or out of macro definition) 

(d) call macros within macro definition 

(e) provide alternate exit points from macros 
(particularly nested macros) 

(f) pass arguments (numeric and non-numeric) and compute 
the number of arguments passed 

(g) provide built in error reporting capability in a macro 

2. create automatic local labels 

3. concatenate strings 

4. generate indefinite and definite repeat blocks 

5. conditional assembly based on the computational results 
of symbols or expressions 

6. two forms of radix control (octal, decimal) and three 
text modes (ASCII*, ASCIZ and 6 bit ASCII) 

7. ability to utilize user designed input/output macros 

8. use local and non-local labels 

9. provide table of contents containing the page numbers, 
text of all assembled .TITLE statements in the program 
and the line numbers on an output listing. 

MACH permits the programmer to use mnemonic symbols to represent 
instruction operation codes, locations, and numeric quantities. It 
is essentially a comprehensive macro instruction generator. This 






% - 


x Only for UC15 systems. 


h 
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generator permits easy handling of recursive Instruction sequences, 
changing only the arguments. 

The assembler facilitates the development of instructions called 
"macros" which, when used as a source statement, can cause a specific 
sequence of instructions to be generated in the object program. 

Refer to the MAC11 Assembler Programmer's Reference Manual, 
(DEC-15-LMCMA-A-D) for a complete description of the language. 

The only object code produced by MACH is in an absolute format on 
papertape. 

An output listing, showing both the programmer's source coding and 
the binary object program produced by MACH, is printed if desired. 
This listing includes all the symbols used by the programmer with 
their assigned values. If assembly errors are detected, erroneous 
lines are marked with specific letter error codes. 

2.2.4 FOCAL Interpreter 


FOCAL (Formulating On-line Calculations in Algebraic Language) operates 
in on-line conversational mode, using natural language and arithmetic 
terms to establish a simplified environment for the computer aided 
solution of business and scientific arithmetic problems. Included in 
FOCAL are such features as: 

1. Linkage to assembly language (MACRO) routines to establish 
a user library of commonly used functions. 

2. Use of COMMON to facilitate chaining in the same manner 
as FORTRAN IV. 

With FOCAL, the user can generate mathematical models, plot curves, 
solve sets of simultaneous equations in n-dimensional arrays, and do 
much more. Refer to the PDP-15 FOCAL-15 Manual (DEC-15-LF0CA-A-D) for 
a complete description of this program. 

FOCAL library commands allow the user to save and then call programs 
by name. These commands result in files consistent with the DOS 
file format. Such files can be manipulated by other DOS programs, 
such as PIP and EDITOR. FOCAL has commands which allow the segmenta¬ 
tion (chaining) of FOCAL programs. 
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The ability to write FOCAL functions in MACRO assembly language and 
subsequently interface these functions with the FOCAL interpreter 
is an important feature. These functions are processed in the same 
way as the normal internal functions which DEC supplies with the 
interpreter. 

2.3 SYSTEM GENERATOR (SGEN) 


The System Generator (SGEN) is a standard DOS Utility program 
used to modify disk resident system files. SGEN, provided as part 
of the general-purpose package, enables the user to tailor his sys¬ 
tem and add to the supplied software in order to develop a resident 
software system unique to the installation or to his specific needs. 
The user (System Manager) calls the system generator program via the 
Monitor command "SGEN". When SGEN is loaded, it initiates an inter¬ 
active question/answer sequence regarding the following system func¬ 
tions and parameters: 

1. Existence of an extra memory page, 

2. Options, 

3. Type of printer unit used, 

4. Required device handler designations (i.e., the 
standard I/O configuration the user wants for 
the system programs), 

5. Skip-Chain information - Priority Interrupt 
Skip Chain contents and order, 

6. Default assumptions, including: type of tele¬ 
printer used, use of additional 4K of core, etc., 

7. System device designation, 

8. .DAT slot assignments, 

9. Monitor Identification Code to designate the 
privileged access by the System Manager, 

10. Default buffers that are needed at any time during 
a user program, 

11. Default Files Protection Code. 

Careful planning is necessary to ensure that the most efficient system 
will be developed for the user's particular needs. For more informa¬ 
tion, refer to the DOS-SGEN Utility Program Manual ,(DEC-15-USGNA-A-D). 
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2.4 PATCH UTILITY PROGRAM 


PATCH is used to: (1) make corrections to the binary version of many 
system programs on the system device , (2) examine and change any word 

in any disk or DECtape block, or (3) convert relocatable binary pro¬ 
grams into system programs. 

Facilities - provide for: 

1. The selection, examination and alteration of registers 
within DOS System programs, and any data word block on 
mass storage, including the system information blocks, 

SYSBLK and COMBLK; 

2. The installation of suitable relocatable programs 
into a user system as a non-relocatable System pro¬ 
gram; 

3. The loading of absolute programs into a user system 
as a System program. 

The PATCH user must first be logged in under the Monitor Identification 
Code (MIC) to have access to system files. Binary programs which are 
not in system program format (e.g., relocatable link-loadable programs, 
and XCT programs which are executable files built by the System pro¬ 
gram CHAIN) cannot readily be corrected by using PATCH. 

With PATCH the user can: 

1. Select a System program to be patched. 

2. Select a single block to be patched. 

3. Obtain an octal printout of the contents of a par¬ 
ticular location in a program. 

4. Alter the content of the listed location by simply 
typing the desired content in octal. 

5. Use the READ command to either replace or patch a 
system program via Paper Tape input. This enables 
the user to easily make corrected copy available for 
instant use without requiring reassembly, regenera¬ 
tion of a system or core patching. This is most use¬ 
ful for handling small updates or new versions of a 
program. 
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6. Select and open specific word locations within 
SYSBLK or COMBLK. 

7. Select and examine registers within a system IQ area. 

8. Automatically convert relocatable binary files into 
system program format and load the converted file 
onto the system device, provided disk space has been 
reserved by SGEN. This feature permits user programs 

to be called directly from the Monitor. It also enables 
the program to completely overlay its loader, to make 
the most effective use of core storage. 

For more information concerning this System Utility program, refer to 
the PATCH Utility Program Manual (DEC-15-UPATA-A-D). 

2 0 5 CHAIN AND EXECUTE PROGRAMS 

The programs CHAIN and EXECUTE allow the user to segment programs in 
order to construct and run a system of core overlays in an easy and 
straightforward manner. 

CHAIN reserves portions of user core (called COMMON blocks) from one 
segment to another so that the program segments can communicate. The 
FORTRAN IV compiler and the MACRO-15 assembler can reserve COMMON 
blocks for future segmentation. This method of segmentation permits 
multiple overlays of executable code, constants, variables, arrays, 
and labeled COMMON blocks. 

Both system programs are required for segmentation: 

1. CHAIN - processes a version of the Linking Loader 
Code (Object Program code) allowing the user to 
build all the various segments (or chains) of his 
program into an absolute (not relative) executable 
(XCT) type file. 

2. EXECUTE - a control program which initiates loading 
of an executable file and transfers control from one 
chain segment to another. At load-time, EXECUTE is 
faster than the Linking Loader. 



CHAIN organizes subroutines into units called LINKS, which may overlay 
each other. Several LINKS may'overlay a larger LINK without overlay¬ 
ing each other. A LINK is loaded into core when a subroutine within 
the LINK is called, and remains resident until overlayed. A LINK'S 
core image is not recorded or "swapped out when it is overlayed. The 
same image is brought into core each time a LINK is loaded. For maxi- 
mum run-time efficiency, segments must be processed serially. See 
the PDP-15 CHAIN and EXECUTION llanuai fob"detailed instructions 
(DEC-15-YWZB-DN2). 

2.5.1 Advantages/Disadvantages of CHAIN & EXECUTE 

2.5.1.1 Advantages 

1. CHAIN 

a. Can build an operable program whose core requirement is 
larger than that of the run-time machine? 

b. Can be used to create elaborate overlay structures; 

c. Is more efficient than using the .OVRLA System Macro 
(see 5.2.2.5)? 

d. Allows the user to request a detailed load map? 

e. Generates core image files which are smaller than 
relocatable binary files. 

2. EXECUTE 

a. Its loader is more core efficient than the Link¬ 
ing Loader since Linking Loader code is processed 
only once; 

b. Is smaller at load time than the Linking Loader; 

c. Gives faster execution times. 

Disadvantages 

One additional step is required to process Object Code 
in preparation for run time. 

DDT (Dynamic Debugging Technique) cannot be used with 
a segmented program. 

At run-time, the execution of a segmented file requires 
a certain amount of processing overhead. 

2.6 LINKING LOADER 

The Linking Loader loads any FORTRAN IV or MACRO-15 object program 
which exists in relocatable format. Its tasks include relocation of 
programs, loading of called external subroutines, retrieval and 


2 . 5 . 1.2 
1 . 

2 . 


3. 
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loading of implied subroutines, and building and relocation of the 
necessary symbol tables. See the Linking Loader Utility Program Manual 
(DEC-15-YWZB-DN8) for detailed instructions. 

The loader first loads all the named programs included in the keyboard 
command string. It then additionally loads and links all requested 
library subprograms. The requested library subprograms are loaded 
from the device handler directory (IOS) , the external (user) library, 
if one exists, and the bank or page mode system library (BNK or PAG). 

In addition, the loader can type out a core map which specifies the 
name and address of each program, subprogram, library routine, .GLOBL 
and common block loaded. 

2 * 7 DYNAMIC DEBUGGING TECHNIQUE (DDT) PROGRAM 

DDT provides on-line debugging facilities that enable the user to load 
and operate his program in a real-time environment while maintaining 
strict control over each program section. DDT allows the operator to 
insert and delete breakpoints, examine and change registers, patch 
programs, and search for specific constants or word formats. 

A breakpoint halts operation when the program flow arrives at the 
designated location. The DDT breakpoint feature allows the insertion 
and simultaneous use of up to four breakpoints, any or all of which 
may be removed with a single keyboard command. The search facility 
allows the operator to specify a search through any part or all of 
an object program with a printout of the locations of all registers 
that are equal (or unequal) to a specified constant. This search 
feature also works for portions of words, as modified by a mask. 

With DDT, registers may be examined and modified in either instruction 
format or octal code, and addresses may be specified in symbolic rela¬ 
tive, octal relative, or octal absolute. Patches may be inserted in 
either MACRO source language or octal. For more information, refer 
to the Dynamic Debugging Technique, Utility Program (DEC-15-YWZA-DN1). 


2.8 DUMP PROGRAM 

DUMP gives the user the ability to output, on any device specified, 
core locations that have been preserved on disk via the CTRL Q (to) 
Monitor command. It also provides the ability to dump DECtape or 
disk blocks onto any device. For more information refer to the Key¬ 
board Command Guide (DEC-15-ODKCA-A—D). 
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2.9 MAGNETIC TAPE DUMP (MTDUMP) UTILITY PROGRAM 

The MTDUMP program provides the user who employs magnetic tape as a 
storage medium with the ability to view and manipulate any named 
portion (i.e., file) of a tape. 

Some of the features provided by MTDUMP are: 

a. Files may be output (dumped) onto any system device 
in any of four possible formats. 

b. Comments may be inserted into a DUMP file. 

c. Files may be copied onto another tape. 

d- Magtape directories can be listed and cleared. 

For more information, refer to the MTDUMP, Utility Program 
(DEC-15-YWZB-DN4). 

2.1° TEXT EDITOR PROGRAMS, EDIT, EDITVP AND EDITVT 

The Text Editor provides the ability to read alphanumeric text from 
paper tape. Disk Cartridge, DECdisk and Disk Pack, DECtape, etc. 

The user can then examine and correct the text, writing it back on 
paper tape. Disk Cartridge, Disk Pack, DECdisk, and DECtape devices. 
Programmers can also use the Text Editor to create new symbolic programs 

The Editor operates on lines of symbolic text delimited by carriage 
return (CR) or ALT MODE characters. These lines can be read into a 
buffer, selectively examined, moved, deleted, or modified, and writ" 
ten out. New text may be substituted, inserted, or appended. 

The programs EDITVP and EDITVT are similar to EDIT except that they 
permit text to be displayed on the VP15A Graphic Display and VT15 
(CRT). Refer to the EDIT Utility Program Manual (DEC-15-YWZB-DN6). 

2 * 11 PERIPHERAL INTERCHANGE PROGRAM (PIP) 


PIP can transfer data files from any input device to any output 
device. It can be used to 

(1) refresh file directories on disk or DECtape, 

(2) list file directory contents on disk or DECtape, 
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(3) 


delete, insert, segment, or combine files, 

(4) perform code conversions, 

(5) assign protection codes, 

(.61 transfer files, or 

(7) copy the entire contents of disk and DECtape storage units. 

It may also be used to update and allocate restricted disk storage 
surfaces. Refer to the PIP (DOS Monitor) Utility Manual 
(DEC-15-UPIPA-A-D). 

2.12 DECTAPE COPY (DTCOPY) 

This program permits high speed copying of DECtape to DECtape units. 
The advantage of DECtape Copy over the PIP copy function is that DEC¬ 
tape Copy is faster. For more information concerning this utility 
program, refer to the Keyboard Command Guide (DEC-15-0DKCA-A-D). 

2.13 LIBRARY UPDATE PROGRAM 

This system program gives the user the capability to examine, extract, 
and update the binary library files on mass storage devices. For more 
information, refer to the UPDATE Utility Program Manual 
(DEC-15-YWZB-DN7). 

2 o14 SOURCE COMPARE PROGRAM (SRCCOM) 

The SRCCOM program compares any two symbolic source programs (ASCII) 
and indicates their differences. This program is useful for program 
identification and/or verification, proofing an edited program, com¬ 
parison of old and new versions of the same program, etc. For more 
information, refer to the SRCCOM Utility Program M.anual 
(DEC-15-YWZB-DNll). 

2 . 15 GRAPHIC-15 

Within this stand-alone system, VT-15 Graphics Software programs are 
used to compile display commands, define display elements, and direct 
linking, displaying and deleting of the elements necessary for a DOS 
resident graphics run-time system. Subprograms provided include: sub¬ 
picture routines, main display file routines, input routines, relocat¬ 
ing routines, and system I/O device handlers resident in the DOS I/O 
Service (IOS) directory. For more information refer to the GRAPHIC15 
Programming Manual (DEC-15-GVTPA-A-D). 
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2.16 PDP-8 TO PDP-15 TRANSLATOR (8TRAN) 


This program is used as an aid in translating programs written in the 
assembly languages of the Digital PDP-8 computer (PAL III, MACRO-8) 
into MACRO-15 form. The translator does not produce an executable 
program, but translates a major portion of the PDP-8 code into equi¬ 
valent MACRO-15 code and indicates those areas of the 8 program which 
must be reviewed and processed by the programmer. For more informa¬ 
tion see the PDP-15 8-TRAN Manual (DEC-15-ENZA-D). 

2.17 PDP-8 TO PDP-9 TRANSLATOR (89TRAN) 

The PDP-8/PDP-9 Translator is used to translate programs written for 
PDP-8 in PAL III or MACRO-8 assembly language to MACRO-9 assembly 
language. This translator is available as a DOS system program for 
a user installation consisting of several DEC computers including a 
PDP-8, a PDP-9, and a PDP-15. For detailed information concerning 
this program, refer to the 89TRAN Manual , (DEC-09-ENZA-D)» 


2.18 VP15A GRAPHICS SOFTWARE 

The VP15A Graphics Software package consists of a group of routines 
which can be used with either FORTRAN IV or MACRO-15 programs to 
operate the VP15A Storage Tube Display. Included in the package 
are an I/O device handler, text, point-plotting, and other routines, 
all described in the VP15A Graphics Software Manual (DEC-X5-UXSB-D). 
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CHAPTER 3 


SYSTEM CONCEPTS 

3*1 DOS-15 MONITORING FUNCTIONS 

There are three sections to the DOS-15 Monitor; (1) the Resident 
Monitor, (2) the Nonresident Monitor, and (3) the System Loader. 

For a UC15 system, there is a fourth section, PIREX, that runs on the 
PDP-11. 

The Resident Monitor remains in core when system or user programs 
are running, and acts as the interface between the program and the 
system’s facilities. PIREX is always core resident in the UC15 
system. It acts as a communication link between two tasks in addition 
to performing other operations like scheduling tasks, etc. (For more 
information refer to DEC-15-XUCMA-A-D.) During program operation, 
the Resident Monitor has general control over the system. It functions 
to: 

1. Maintain orderly program flow, 

2. Handle teleprinter I/O, 

3. Act on Monitor calls, 

4. Validate and transmit I/O calls to device handlers, 

5. Announce error diagnostics. 

The operator may alter the structure of the Resident Monitor via 
commands to the Nonresident Monitor. The Nonresident Monitor allows 
the operator to interrogate and alter many key parts of the system, 
in order to set up the system for the next program. It functions to 

1. Set I/O conditions by assigning physical devices to 
logical unit numbers, 

2. Supply system information, 

3. Save or restore core images, 

4. Load and Execute system and user programs, 

5. Change default system parameters. 

Normally, at the end of a particular program, the operator, the Batch¬ 
ing Command String, or the program itself returns control to the Non- 
resident Monitor. At that point, the operator or the Batching Command 
String sets up the system for the next program and calls it in via 
commands to the Nonresident Monitor. 

The System Loader (.SYSLD) builds the Resident Monitor according to 
prior commands to the Nonresident Monitor. It loads (a) all core¬ 
image system programs and all I/O handlers for those system programs, j 
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(b) the Linking Loader or (c) EXECUTE. In almost all cases, a change 
of program involves actions by the System Loader. The System Loader, 
however, is completely invisible to the user except for LOAD errors, 
such as insufficient core. 

The DOS-15 Software System provides an interface between the system 
or user-created program and the external world of I/O devices. This 
simplifies I/O programming. This interface is comprised of a function¬ 
ally related group of software called the Input/Output Programming Sys¬ 
tem, or simply IOPS. This is a conceptual term which encompasses 

(1) the I/O device handling routines within DOS-15, 

(.2) a portion of the Monitor which is used in dis¬ 
patching I/O commands to them, and 
(3) a Monitor routine for printing error messages. 

I/O device handlers are provided for all standard devices (see Chapter 
9). These handlers relieve the user of the burden of I/O service, 
file management, overlapping I/O considerations and unwanted device 
dependence. I/O commands and data modes are standardized and are 
recognized by DOS-15 device handlers. This facilitates device independ¬ 
ence. For example, a non-file structured device handler such as the 
paper tape reader will ignore (rather than declare an error) a command 
to "seek a file" (which is required for file structured devices prior 
to issuing commands to read). There are other features of the system 
which contribute to device independence; they are discussed in later 
paragraphs. 

3.1.1 System Communication Table (SCOM) 

The System Communication Table (SCOM) is a set of registers that are 
referenced by the Monitor, I/O device handlers, and other system pro¬ 
grams. It acts as a common parameter area for information required by 
both the System Loader and Monitor. User programs may also utilize 
the information in this table as desired. The System Communication 

Table begins at absolute location 100 o (Bank 0 ). 

a 

The following list briefly outlines some of the SCOM table functions: 

Free Core Limits 
Option Availability 

System and User Program Start Addresses 
Handlers 





r 
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Interrupt Levels 
Magtape Status Register 
Number of Buffers Allocated 
Number of Words/Buffer 

Number of Entries in Mass Storage Busy Table 
User Identification Code 
Software Control Switches 
Date (MMDDYY) 

Time (HHMMSS) and other Clock Information 
Default Protection Code for Files 

A complete list of the SCOM table functions is given in the DOS System 
Manual (DEC-15-0DFFA-B-D) . > 

3-1.2 Monitor/User Interaction 

The console teleprinter is the primary user-system interface for 
DOS-15 program control. This control is implemented by commands to 
the Monitor, which accepts the three types described below: 

1. Commands which perform special services 

3* Commands which loadsystem programs 

Control character commands which provide system 
control while running user or system programs. 

NOTE 

the context of this manual, the term "console 
keyboard" designates any one of several keyboard/ 
printer/display I/O devices which could be used 
by the Monitor as the system command console de¬ 
vice. 


The operator at the keyboard types commands to allocate system re¬ 
sources, load and start System and user programs, terminate program 
operation, and exchange information with the Monitor. Most of the 
Monitor's keyboard commands are issued prior to loading programs and 
are interpreted by the Nonresident Monitor, since it is not resident 
m core during system or user program execution. During program exe¬ 
cution, a small set of keyboard commands is available for general 
program control. These commands are interpreted by the teleprinter's 
I/O device handler (which is part of the resident portion of the 
Monitor), and are used to control program start and restart, dumping 
of core, and the reloading of the Nonresident Monitor. Details on 
the DOS-15 commands which can be issued from the console keyboard are 
described in Chapter 8. 
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The keyboard commands are, however, not strictly limited to input from 
the keyboard. The Monitor can be operated in a Command Batching Mode 
in which keyboard commands can be issued either from punched cards 1 or 
paper tape with minimum operator intervention. Similarly, the Monitor's 
responses to commands are not strictly limited to a keyboard device’s 
printer or display, but may also be output to other devices including 
the VT15 Display or a line printer, when available. 

3 * 2 1/0 COMMUNICATION 

The Monitor, by means of Device Handlers and Priority Interrupt (PI) 
or optional Automatic Priority Interrupt (API), permits simultaneous 
operation of I/O devices along with overlapping computations. 

A system or user program initiates an I/O function by means of a 
Monitor command (system macro), which is interpreted within the 
Monitor as a legitimate I/O call. The I/O call includes a logical 
I/O device number as one of its arguments. The Monitor establishes 
the logical/physical I/O device association by means of a special 
table. When this has been accomplished, the Monitor passes control 
to the appropriate device handler to initiate the I/O function, 
after which control is returned to the system or user program. 

The system or user program retains control until an interrupt (PI or 
API) occurs; at this time the device handler takes control, in order 
to perform and/or complete the specified I/O function. The program 
may continue computation or other processing while waiting for 
I/O completion. This feature allows the programmer to make optimum 
use of available time. 

3.2.1 Device Independence 

In the DOS Monitor environment, the system manager may set up default 
device associations (correspondence between logical/physical devices) 
during system generation. Just prior to loading a system or user 
program, a user may change these associations via the ASSIGN keyboard 
command. This capability adds true device independence to DOS-15. 

All device handlers are nonresident in the sense that only those handlers 
required by a program are loaded into core. 


: This capability is available only with the CR03B card reader. 
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3.2.2 I/O Device Handlers 

Users are spared the task of writing system software to handle input/ 
output to all standard system peripherals, since appropriate routines 
(Device Handlers) are supplied with the DOS Monitor. These routines 
process file and data level commands to the peripheral device. They 
generally perform the following functions: 

1. Drive I/O devices, 

2. Block Data Records for Devices, if necessary 

3. Manipulate files, 

4. Optimize device timing, 

5. Allocate/Deallocate Storage Space on the device, 

6. Request/Return core space. 

All communication between user programs and I/O device handlers is 
made via I/O Macros. Macros are covered in Chapters 5 and 6. 

There may be available in the system several handler versions for a 
particular device (e.g., DKA, DKB, DKC). Each represents different 
compromises between core use and handler flexibility. Device handlers 
are covered in depth in Chapter 9. 

3.2.3 Device Assignment Table (.DAT) 

The DOS Monitor contains a Device Assignment Table (.DAT), with an en¬ 
try for each device used. Since the contents of the table can be al¬ 
tered by commands to the Monitor, actual I/O devices may be changed 
without altering the program references (logical device units) to these 
devices. Refer to Chapter 4 for more information concerning .DAT. 

3 * 3 FILE STRUCTURES 

A file structure, as defined for DOS-15, is a method of recording, link¬ 
ing and cataloging data files. Each peripheral device has an associ¬ 
ated file structure which governs the manner in which data are stored. 

Card files and paper tape files are always organized as sequen¬ 
tial files and both files and records are processed sequentially. 

fils or record in the middle of the medium can only be accessed 
after all preceding items have been processed. This is a restric¬ 
tion which is a consequence of the nature of the storage medium. 

In contrast, DOS-15 provides direct access to files stored on 
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DECtape or disk. The system maintains directories on these devices 
that point to each file on the device. Hence, such devices are called 
"directoried" or "file-oriented". Both DECtape and Magnetic tape 
(Magtape) permit the user to operate either in a directoried or a 
non-directoried (sequential) mode. The system maintains a mini¬ 
directory for each file which points to each physical block in the file. 

The user of the PDP-15 Disk Operating System is not required to pre¬ 
allocate file storage; the operating system provides the file storage 
space dynamically on demand. Not only is this convenient for the user 
because he does not have to worry about allocation when he is creating 
files, but it conserves storage by preventing large portions of storage 
from being unnecessarily tied up. More information on this topic can 
be found in Chapter 4. 

3.3.1 User File Directories and UIC's 

On DECtape, there is only one directory for the whole tape. On disk, 
there is a central directory, called the Master File Directory (MFD), 
but each user can have his own User File Directory (UFD). The MFD 
points to each UFD. Each UFD is named by a unique three character 
User Identification Code (UIC). The User File Directory Table (.UFDT) 
is part of the Resident Monitor associated with the Device Assignment 
Table. It indicates the User Identification Code (UIC) associated with 
every .DAT slot (i.e., each logical device). Disk I/O to a particular 
.DAT slot will go to files in the UFD named by the corresponding .UFDT 
slot. 

The Monitor finds User File Directories by seeking associated User 
Identification Codes (UIC's), which are all listed in the Master File 
Directory. The UIC is necessary for all directory-oriented I/O to the 
disk. A programmer may identify himself (LOGIN) to the system with 
only one UIC at a time, but he may have as many UIC's as he wishes, 
provided each is unique and none is reserved 1 . Further, programs may 
simultaneously reference files under several different UIC's. 

3.3.2 Monitor Identification Code (MIC) 

A three-character Monitor Identification Code (MIC) is established at 
system generation time to provide privileged access by the System Man¬ 
ager. When the System Manager uses the MIC, all system and user files 
are open for reference or change. This code acts as a key to temporar¬ 
ily remove file protection. System generation, modification of system 

1 The LOGIN keyboard command is described in Chapter 8. 
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programs and listings of the entire disk directory are allowed only 
under the Monitor Identification Code. 

3.4 FILE PROTECTION 

DOS-15 offers a simplified form of file protection. Each User File 
Directory has a protection code (optionally specified in commands to 
PIP) , and each file has a protection code (optionally specified in 
the .ENTER command or a command to PIP). The protection codes are 
in effect only when a user tries to reference a file listed under a 
UIC other than the one currently logged in to the system. If a User 
File Directory is protected, then the protection is provided for any 
file in the directory. For more information, refer to Chapter 6. 

The default protection code for the files is established at system 
generation time. Users may temporarily change the file default pro¬ 
tection code via the PROTECT command to the Monitor. (See Chapter 8.) 

3.5 I/O BUFFERS 

Two Monitor commands allow any handler or user program to call the 
Monitor to allocate and deallocate buffers. Each buffer is obtained 
from a "buffer pool" as needed. For more information, refer to 
Chapter 6. 

3.6 CHOICE OF EXECUTABLE FORM 

The object code usually produced by FORTRAN IV and MACRO-15 is re¬ 
locatable binary which is made absolute by CHAIN, or loaded at run 
time by the Linking Loader. In addition to relocatable output, the 
MACRO-15 user may specify non-relocatable types of output code. In a 
UC15 system, the user can produce absolute binary papertapes from MAC11, 
a MACRO-11 assembler. No direct loading facility in the form of a 
loader is provided with it, (the user can write his own simple loader 
program) although PIREX has execution facilities. j 

3.6.1 Relocatable Binary ! 'i 

A relocatable object program may be loaded into any part of memory, 
regardless of which locations are assigned at assembly or compile 
time. To accomplish this, the address portion of some instructions 
must have a relocation constant added to it. This relocation constant 
is added during segmentation, by CHAIN, or at load time by the Link¬ 
ing Loader. It is equal to the difference between the actual memory 
location that an instruction is leaded into and the location that 
was assigned to it at assembly time. The language processors use 
codes to identify storage words as relocatable, absolute, or external. 
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Relocatable Binary object programs may be placed into and executed 
from any part of memory, regardless of the core locations assigned to 
the instructions by the language translator. The primary advantage 
of such a system is that it enables the user to easily write and load 
into core memory many programs (e.g., the main program and several 
subroutines) with no necessity for prior core mapping. Relocatable 
Binary is always produced by FORTRAN and is produced by MACRO-15 when 
there are no .ABS or .FULL pseudo-ops. 

3.6.2 Absolute Binary Forms 

Absolute Binary object code is produced using the MACRO-15 Assembler's 
.ABS, .ABSP, .FULL, or .FULLP pseudo-ops as described below. Programs 
assembled with these pseudo-ops are loaded and executed independently 
of the DOS-15 System software. Refer to the MACRO-15 Assembler Manual 
(DEC-15-LMACA-B-D) for more information. MACH produces only an 
absolute binary format (this format is different from DOS-15)„ Refer 
to the MACll Assembler Manual (DEC-15-LMCMA-A-D)„ 

3.6.2.1 0 ABS and .ABSP Binary - The".ABS and .ABSP binary forms are 
checksummed binary coded programs or instructions assembled as .ABS 
(Absolute Binary) and assigned to occupy specific or absolute loca¬ 
tions in core memory. These programs can only be loaded into or 
executed from the locations assigned by the language translator. 

The task of placing multiple routines into core for execution becomes 
a tedious one. Absolute binary does have the advantage of a smaller 
loader, thus enabling the user to execute a larger program than is 
possible using relocatable binary. Ordinarily, the Assembler will 
precede the output with an Absolute Binary Loader which will load 
the punched output at object time. The loader is itself loaded via 
Hardware Read-in Mode. 

3.6.2.2 .FULL and .FULLP Binary - The .FULL and .FULLP binary forms 
are unchecksummed binary consisting solely of 18-bit storage words. 
Programs assembled in this form are output on paper tape and are 
loaded via Hardware Read-in Mode. 

3.7 LOADER CONTROL 

As indicated in the previous section, CHAIN and the Linking Loader 
make relocatable object programs absolutely addressed. In addition, 
they join relocatable programs by supplying definitions for global 
symbols which are referenced in one program and defined in another. 



3.7.1 Globals 

The global feature is another of the programmer conveniences provided 
by the MACRO-15 Assembler. It allows the user to provide a symbolic 
linkage between separately assembled programs including: a main pro¬ 
gram, subprograms, and general subroutines in system (Bank or Page) 
Libraries or User Libraries. 

In MACRO-15, the pseudo-op .GLOBL, followed by a list of symbols, is 
used to define to the Assembler two Irypes of global symbols: 

1. , Internal Globals - defined in the current program 

and referenced by other programs. 

2. External Symbols - referenced in the current pro¬ 
gram and defined in another program. Each external 
symbol will be used by the Linking Loader or CHAIN 
to store the actual address. All references to ex¬ 
ternal symbols should be indirect references, as 
memory banks may have to be crossed. 

The FORTRAN equivalents to external and internal .GLOBL's are CALL and 
SUBROUTINE. The Linking Loader and CHAIN use this information to re¬ 
locate and then link the programs to each other. 

3.7.2 Program Loading 

At program load time, the user, via appropriate keyboard commands, can 
select either Page or Bank Mode program loading and execution. Two 
versions of the Linking Loader and System Library are provided - one for 
each mode. 

3.7.2.1 Page Mode Operation - The DOS Monitor Page Mode System 
loads and relocates user programs in 4K pages and permits address 
modification via the index register (Index Addressing). In Page 
Mode, the loader obtains library routines from the library in the 
PAG System file directory. The Page Mode System is supplied as 
standard software with PDP-15 systems. 

3.7.2.2 Bank Mode Operation - The optional Bank Mode system permits 
direct accesing within 8K banks, but does not permit the use of the 
index register for address modification. This system is useful to 
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the PDP-15 user who prefers direct addressing up to 8K, or who wishes 
to take advantage of the extensive library of PDP-9 programs available 
from the Digital Equipment Computer User's Society (DECUS). All 
core-image system programs run in Bank Mode. In Bank Mode, the 
loader obtains library routines from the library in the BNK System 
file directory. 

3.8 ERROR DETECTION 

Comprehensive error checking and recovery are provided by the DOS-15 
Monitor, the loaders, and the I/O system as follows: 

a. DOS-15 Monitor Errors - error conditions related to 
system devices, illegal device assignment, program 
name, and command references. 

b. Linking and System Loader errors - memory overflow, 
input data errors, unresolved globals, and illegal 
•DAT Slot requests. 

c. IOPS Errors - all Input/Output device and data errors. 

Detailed lists of errors that occur in the latter two categories can 
be found in Appendices D and E, respectively. The Monitor Errors, when 
they occur, are easily understood and recovery will be self-evident. 

The automatic core-dump commands QDUMP or CTRL Q will condition the 
Monitor to dump memory on the "save" or "CTRL Q" area of one of the 
units of the system device, in the event of an unrecoverable error. 

Terminal errors are not reported to the user's operating programs? 
there are, however, a few I/O-detected errors that are reported to the 
user for program use, e.g., parity, checksum, and buffer overflow errors 
are indicated in special control words of each' IOPS data record (see 
Chapter 6). Error detection and recovery are discussed in Chapter 10. 

After error messages are output, the user may optionally restart the 
program (CTRL P), dump core (CTRL Q), or return control to the Non¬ 
resident Monitor (CTRL C). Other options are available to the user 
when errors occur; these will be discussed in succeeding chapters of 
this manual. 
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3.9 INPUT/OUTPUT SPOOLING 

The Unichannel-15 configuration allows spooling of tasks using PDP-11 
peripherals and memory. The actual spooling program (SPOLll) resides 
in PDP-11 (local) memory while a special interfacing program for the 
spooling function (SPOOL) resides in PDP-15 (common) memory. Both of 
these spooling program modules are resident on the system disk. 

The spooling function operates under DOS-15 or BOSS-15 1 . For further 
information regarding spooling of tasks, refer to the UC15 software 
manual (DEC—15-XUCMA-A-D). 

The Unichannel-15 RK based system supports full, input spooling from 
the Card Reader (CR11), and, output spooling to the Line Printer 
(LP11/LS11) and plotter (XY11) utilizing the RK05 disk cartridge. The 
actual spooling program is resident in the PDP-11 (local) memory when 
spooling is enabled. It is dynamically connected or disconnected with 
PIREX at run time. 


The spooling operations are controlled in DOS-15 through the SPOOL 
system program. The SPOOL program accepts single character directives 
followed by a 'carriage return* or 'ALT Mode 8 . The following is a 
summary of the directives: 


Directive Meaning 


Description 


B BEGIN Enable and, if input task, start spooling 

of data. The actual spooling program is 
connected to PIREX provided there is suffi¬ 
cient free local memory space. All output 
to Line Printer, plotter and input from 
Card Reader will then be spooled until an 
'E' command is issued® 

E END Disable or terminate spooling operations. 

The actual spooling program is disconnected 
from PIREX. 

Appendix I lists the various error messages that are issued when the 
indicated conditions arise. 


1 Available only on UC15 systems with an RK05 Disk Cartridge utilized 
as the system disk. 
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Users are advised to include the .CLOSE X statement if writing a 
MACRO-15 program or an ENDFILE X statement if writing a FORTRAN pro¬ 
gram e where X is the .DAT slot assigned to the Line Printer/Plotter 
to ensure output of the last few records. In the absence of this 
statement , the last few records will be outputted only after the 
spooler internal buffer containing these records is full. 
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CHAPTER 4 

FILE STRUCTURES 

4.1 INTRODUCTION 

This chapter will define those concepts and facilities of the DOS-15 
system that are available for storage and retrieval of data from PDP-15 
mass-storage hardware/software systems, including DECdisk (RF), Disk 
Pack (RP), Magtape (MT), DECtape (DT) and Disk Cartridge (RK)* 

A large part of any programming task is accepting input and producing 
output. Therefore, it is necessary to understand the Input/Output 
process to take full advantage of the Disk Operating System's features. 

4.2 DEVICE ASSIGNMENTS 

As stated in the previous chapter, device assignment is managed through 
the Monitor's Device Assignment Table (.DAT). The .DAT associates 
logical device units with physical ones through "slot" numbers, which 
correspond to the logical device numbers. 

Device assignment slots are assignable via the Monitor ASSIGN command 
at run time. Refer to Section 8.5 of Chapter 8 for more information. 
Default assignments are defined during system generation (see SGEN 
Utility Program Manual (DEC-15-USGNA-A-D). Information in each program 
indicates which "slots" are required for that program. These slots 
are called the "active slots". The loaders use the information about 
active slots to bring in handlers for the devices named by the active 
slots. At run time, then, each slot contains the physical device unit 
number (if any), and a pointer to the appropriate device handler, which 
was brought in by the loader. Without device assignment on a .DAT 
slot, a program's call to that slot will result in an I/O error — the 
slot will not point to a handler. Depending on the system generation, 
as many as seventy—three entries may be in the .DAT for program device 
assignment. 

Each I/O command under DOS-15 references a .DAT slot. These commands 
pass control to the appropriate device handlers via a Monitor routine 
that uses the pointers in the .DAT. These device handlers are 
responsible for transferring data between the program and I/O devices. 
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They also initiate the physical reading or writing of files and perforin 
opening and closing of files and other functions peculiar to a given 
hardware device. Each slot then links the device-driving functions 
within a specified device handler to the program. The handlers all test 
for functions which they cannot service; for example, trying to rewind 
a card reader. Some functions are ignored; others are illegal and 
cause error messages to be output to the console teleprinter. All de¬ 
vice handlers operate either with or without the Automatic Priority 
Interrupt (API) option. 

4.3 FILES 

A file is a collection of related records treated as a unit. In 
Inventory Control, for example, one line of an invoice forms an item, 
a complete invoice forms a record, and the complete set of such 
records forms a file. The word "file" is used in the general sense 
to mean any collection of information items similar to one another in 
purpose, form and content. "File" may also be generally applied to 
external storage media such as papertape, punched cards, a Magtape, | 
a DECtape, DECdisk platters, Disk Cartridge and a Disk Pack„ 

4.3.1 Records 

In DOS-15, a record is a set of one or more related data words acces¬ 
sible to the user as one item through .READ and .WRITE MACRO program 
statements or FORTRAN language statements. (Chapter 6 describes .READ 
and .WRITE). The smallest addressable logical item within the file 
is this logical record. 

4.3.2 Words 

A word is the least addressable physical data unit 0 


I/O Buffers are internal to, and must be defined by, each program. 
With the exception of certain block transfers, a buffer contains a 
single record. Under most of the Data Modes (described below), the 
first two words in an I/O buffer (i.e., a record) provide system in 
formation and cannot be used for data. This Header Word Pair with¬ 
in an I/O buffer is detailed in Chapter 6. On blocked devices 
(Disk and DECtape), these header word pairs govern the physical 
structure within the file. Before output, the user must set up the 
Header Word Pair. On input, the Header Word Pair arrives with Data 
Mode Information and certain error indicators. The user is 



responsible for checking the various header parameters to determine if 
the data was read without error. 

4.3.3 Data Modes 


The Monitor allows data transmission to or from a system or user pro¬ 
gram in several different modes which structure internal data storage. 
Two modes, IOPS ASCII and IOPS Binary, offer the advantages of device 
independence. All handlers accept IOPS ASCII data, and most accept 
IOPS Binary. Three other data modes. Dump, Image Alphanumeric and 
Image Binary,allow the user to take advantage of device dependent 
characteristics. For more information, refer to Chapter 6. 

4.4 FILE STRUCTURES 


As stated in Chapter 3, a file structure is a method of recording, 
linking, and cataloging data files. File structuring, in general, is 
applicable to all I/O devices, including cards, paper tape, printers, 
keyboards, etc. In DOS-15, however, file structures are associated 
with Mass Storage devices only. A file structure dictates the file 
and record access methods. This organizational structuring is import¬ 
ant because a file can be effective for a user application only if it 
is designated to meet specific requirements. A user must consider 
the following factors: 


SIZE 

ACTIVITY 


Growth of the file may require a change 
in file structure or data mode. 

- The need to access many different records 
within a file (percentage of activity) or 
to frequently access the same records (an 
active file) will influence information 
retrieval efficiency. This requires the 
user to select the right method for each 
job task. 

The number of additions and deletions to 
a file will affect the efficiency of the 
structures used. 


VOLATILITY 





4.4.1 File and Data Access Techniques 


The usual technique for applications using Magtape is sequential ac¬ 
cess to the data file and sequential access of the data records. 

This access is also characteristic of most uni-directional media, 
such as cards, paper tape, keyboards, printers, and displays. 

Another technique, which in DOS-15 is applicable only to the disks, 
involves random-access (an alternate term is "direct-access") to a 
file and random-access of data records within the file. 

A third and intermediate technique, which is normally used on DECtape 
and on disk, employs random-access to a file and sequential access to 
the file's data records. The formal term is "random-sequential file 
structure"; the informal term is "DECtape file structure". 

4.4.2 Sequential Access 

Sequential access is a storage retrieval technique in which a file 
and the records within it must be retrieved in the sequence in which 
they physically occur. Sequential access, when applied to the 
process of locating the beginning of a file or a data record within 
the file, means that the time required for such access is dependent 
on the necessity for waiting while non-desired records are processed 
in turn. 

1. Records can only be retrieved sequentially, beginning 
with the first record and accessing each subsequent 
record in turn. 

2. Direct retrieval is not possible, since no directory 
exists to the physical locations of the records. 

3. When adding or deleting a record, the system copies all the 
records preceding that record in the file, then performs 
the addition or deletion. The system then recopies all the 
remaining records in the file. 


4.4.3 Direct Access 

Direct access to a file or to a data record within the file means 
that the time required for such access is independent of the location 
of the file or record relative to other files or records. 

Direct access should be considered as a valuable access method when 
retrieving selected records from random files; but it is not suited 



for sequential retrieval of records. The direct access technique 
makes it possible to process only the affected record during a file 
update. This reduces data sorting. 

The main advantage of direct access processing is that it requires 
fewer processing steps. Along with its advantages, however, a direct 
access application requires special considerations by the system pro- 
grammer. Backup on a direct access system differs from backup on a 
tape system because the old record on a direct access device is 
destroyed when the updated record is written over it. 

4.5 MAGNETIC TAPE FILE STRUCTURE 

The DOS software provides for industry-compatible magnetic tape (Mag¬ 
tape) as either a directoried or a non-directoried medium. The 
magnetic tape handlers communicate with a single Tape Control Unit 
(TCU) with up to eight magnetic tape transports. 

When used as a non-directoried medium, there are a numbet of major dif¬ 
ferences between Magtape and other mass storage devices such as DECtape 
or Disk. Magtape is well suited for handling data records of variable 
length? such records, however, must be treated in serial fashion. The 
physical position of any record may be defined only in relation to the 
preceding record. 


When used as a directoried medium, Magtape assumes the external opera¬ 
ting characteristics of DECtape (described in 4.6) . 


Sequential tape files are written one after the other, starting at the 
physical beginning of the tape. These files are separated from one 


another by End-of-File marks (hardware-detected) or by an End-of-Record 
line (software-detected). (Refer to Figure 4-1, Sequential Data Access.) 
To read the N file on a tape, the user must first rewind to the begin¬ 
ning of the tape and then skip serially through N—1 files to the desired 


file. Sequential tape files need not have a filename, only a known 
position relative to the files on the tape. 


Data records within a file are recorded in sequence. Sequential state¬ 
ments direct records to and from memory in the Sequence in which they 
are physically on the device. To access the M th record within the N th 
file, the user first locates the beginning of the file (skipping N—1 
files) and then skips through M-l records. 


4-5 





This sequential access method, does not need a tape-resident directory 
to point to files. It is, therefore, called "non-directoried" in DOS. 
The non-directoried access method is generally applicable to unit- 
record peripheral devices. 

4 - 6 DECTAPE FILE STRUCTURE 

If magnetic tape transports could identify absolute positions on a 
tape, there would be no need to do sequential file access. The trans¬ 
port could search to a known location, and start processing. Then, 
an extra body of information (a directory) on the tape could point 
to each file. DECtape has this capability. 

In directoried mode, files are given unique names. The name and posi¬ 
tion of the beginning of a file are recorded in a directory. Direc¬ 
tories are at a fixed location (Block Ij2(j2fg) on the tape. DECtape direc 
tories point to the first block of each file and each block points to 
the next. DECtape directories also maintain bit maps which indicate 
which tape blocks each file occupies and a map to show all occupied 
blocks on the tape. The file directory is fixed in size; consequently, 
the number of files that may be recorded is limited by the amount of 
storage available on the device (llOOg blocks) and/or by the number 
of file name slots in the directory (56 maximum). 


4-6 







Figure 4-2, Directoried Data Access 




















File structures which employ a directory allow simpler and, in the long 
run, faster access to a file (the beginning of a file). See Figure 4-2. 
This is a distinct advantage over those devices which do not use a 
directory and must therefore rely on a file's position relative to 
other files in order to locate it. 

Programmers need not use the directory capabilities of DECtape. They 
can treat DECtape as magnetic tape by issuing magnetic tape I/O com¬ 
mands. Then no directory or identifying information of any kind is 
recorded or referenced on the tape and operation is similar to that 
of magnetic tape (described in 4.5). The DECtape handlers with their 
respective I/O functions allow the use of either of these modes. 

4.7 DISK FILE STRUCTURE 

The DOS-15 disk file structure is in some ways analogous to DECtape 
file structure. Ordinarily, each disk user has a directory which 
points to named files, just as each DECtape has a directory. A single 
user's disk directory might correspond to a single DECtape directory. 

The DECtape, however, has only one directory, but the disk has as many 
directories as users have cared to establish. Whereas DECtape direc¬ 
tories may reference only a maxim-urn of 56 1Q files, the number of files 
associated with any one directory on the disk is limited only by the 
available disk space. A single disk file's size is also limited by 
the available space, as is true with DECtape. 

The DECtape directory is in a known location... at block 100 g . Since the 
disk may have a variable number of directories, the Monitor must know 
how to find each user's directory. It, therefore, maintains a Master 
File Directory (MFD) at a known location, and the Master File Directory 
points to each User File Directory (UFD). DOS-15 allows only those 
users who know a special code, called the Monitor Identification Code 
(MIC), to have access to the MFD. Figure 4-3, Disk Data Access, 
illustrates the organization of the disk. 


4.7.1 User Identification Codes (UIC) 

The Monitor finds User File Directories by seeking associated User 
Identification Codes (uiC's) which are all listed in the Master File 
Directory. The UIC is a three-character code that is necessary for 



all directory-oriented I/O to the disk- A programmer may establish 
a new User File Directory by: 

1. Logging in his new UIC to the Monitor, 

2. Calling PIP, 

3. Issuing an "N. .DK J " command for RF15 DECdisk or 11 N« .DP Q 11 
for RP02 Disk Pack or "N, a RK 0" for RK05 Cartridge Disk.' 

This establishes a new User File Directory, or refreshes (wipes clean) 
an old directory under that UIC. The "enter file" I/O command will 
also create a UFD, if none exists. 

4.7.2 The User File Directory Table (.UFDT) 

The Monitor must have a way of knowing which User File Directory to 
reference when a program issues I/O commands to the disk. It makes 
the association between disk I/O commands and User File Directories 
by using a User File Directory Table (.UFDT). There are as many 
entries in the User File Directory Table as there are slots in the 
Device Assignment Table. Figure 4-4, Relationship Between the .DAT 
and the .UFDT, shows how the two compare. Disk I/O to a particular 
.DAT slot will affect files in the User File Directory named in the 
corresponding .UFDT slot. Programmers may modify .UFDT slots before 
loading a program, and programs themselves may alter .UFDT. 

4.7.3 File Protection 

DOS-15 offers a simple form of file protection. Each User File 
Directory has a protection code and each file has a protection code. 
The protection codes only protect a programmer's files from other 
users - not from himself.' If a User File Directory is protected, 
then the protection codes for each file are in effect. If the user 
File Directory has been specified as unprotected, then no protection 
is provided for any file in the directory. There are three protec¬ 
tion states possible for files in a protected User File Directory. 

File Protection Codes : 

1 = Unprotected, with the exception that the file 

may not be deleted and the number of blocks may 
not change, if the directory is protected. 

2 = Write protected, if directory protected. 

3 = Read/Write protected, if directory protected. 



.DAT/.UFDT Number 


.DAT Contents 


. UFDT Contents 


Comment 


+N 

nondisk handler 

Y Ic i 

This UIC is ir- 


l 


relevant 

+ 2 

disk handler 

uic 1 

I/O to this slot 
will go to files 
in UIC 

+ 1 

disk pack handler 

UIC 2 

I/O to this slot 
will go to files 
in UIC„ 

* 

• 

• 

2 

-15 

none assigned 

UTCl 

This UIC is ir¬ 
relevant 


The operator has logged in under UIC r He has assigned some nondisk 
handler to .DAT+N, the DECdisk to .DAT+2, and the Disk Pack unit 0 to 
.DAT+1, and NON (no handler) to .DAT -15. In addition, he has changed 
the .UFDT assignment for .UFDT+1 to UIC 2 - I/O to .DAT+N will not 
reference the UIC, since UIC's are relevant only to disk I/O. I/O to 
.DAT+2 will reference UIC^ while I/O to .DAT+1 will reference UIC . 
The UIC for .DAT -15 is irrelevant, since no handler is assigned. 2 


Figure 4-4 

Relationship Between the .DAT and the .UFDT 













User File Directories may have one of two protection states: 


File Directory Protection Codes 

0 = Unprotected 

1 = Protected 

The default protection code for User File Directories is always 1, 
protected. The default protection code for files is established at 
system generation time. 

4.7.4 Organization of Specific Files on Disk 


The disk handlers write out files sequentially, just as the DECtape 
handlers do. On the close of an output file, the disk handlers also 
fill out a Retrieval Information Block (RIB). The RIB performs the 
same functions as the file bitmap on DECtape, and associates the 
logical sequence of blocks in the file with the physical locations of 
the blocks on the disk. The disk handlers use the RIB to implement 
random access and to delete files. 


After a user has created a disk file, he can access records sequentially 
as with DECtape files. He can also read and write physical blocks of 
that file by referencing relative block numbers. The user is prohibited, 
however,, from changing the total number of blocks in the file. 


4.7.5 The Disk Handlers 

The disk handlers allow as many concurrently open input or output 
files as there are .DAT slots available to the user, and buffers 
available to the disk handler. The disk handlers operate under a 
dynamic buffer allocation scheme. Whenever the Monitor loads a sys¬ 
tem or user program, it allocates buffer space. This space is called 
the buffer pool. Whenever a program opens a disk file, the handler 
obtains a buffer from the buffer pool. The handlers return the 
buffer when the program closes the file. 

The buffers in the buffer pool are available to programs, as well as 
to disk handlers. Whenever a program is using a buffer, however, it 
is unavailable to any other program. 






CHAPTER 5 
DOS SYSTEM MACROS 

5.1 introduction 

This chapter contains detailed reference information concerning DOS-15 
System Macros. I/O Macros (those which have a .DAT slot number as one 
argument) are discussed in Chapter 6. 

5.2 MONITOR-PROCESSED COMMANDS 


The MACRO-15 assembler permits the use of higher-level system instruc¬ 
tions called "System Macros" which, when used as a source statement, 
can cause a specific sequence of Monitor operations to occur at run¬ 
time . 

These System Macros are referenced (called) in user programs by writing 
a statement consisting of a System Macro name followed, if needed, by 
a tab, space or spaces, plus a list of arguments separated by commas. 
Macro statements are terminated by either a space or spaces (. ,) , a 
tab ( -*|) , or a carriage return {J). For example: 

* TIMER -*| 5000, TmOUTj 

5.2.1 Summary of DOS Monitor System Macros 

Table 5-1, Summary of System Macros, summarizes the non-I/O macros 
which the Monitor implements. The following paragraphs describe the 
individual system macros in detail. 


Table 5-1 Summary of System Macros 


Name 

Description 



.EXIT 

Requests the System Loader to bring in 
Monitor. 

the 

Nonresident 

.GET 

Overlays core with the contents of a named 

file. 

.GTBUF 

Requests a buffer from the buffer pool. 



.GVBUF 

Returns a buffer to the buffer pool. 



.OVRLA 

Requests the System Loader to load the 
program. 

named core-image 

.PUT 

Creates a file containing the current core 

image. 

.TIMER 

Initializes a time interval after which 
passes to a user specified subroutine. 

program control 




5.2.2 DOS-15 System Macro Expansions 


The following standards apply to the descriptions of the System and I/O 
Macros presented in this chapter and in Chapter 6: 


A. Format 


1. Upper case terminology must be used as stated in the 
FORMAT Description. 

2. Lower case terminology indicates user-supplied information, 
as defined by ARGUMENTS. 

3. Names for user-supplied parameters indicate maximum length 
of field by the number of characters in the name. Thus, 
jnamptr" may be a maximum of six characters long, and 

num" may be a maximum of three characters. 

4. Brackets ([ ]) indicate optional quantities. 

5. A bracket on its side (. *) indicates a space. 


6 . 


7. 


Quantities listed vertically and enclosed in braces ({ }) 
indicate the user must choose one from the group. 


The expansions 
macro directly 
different from 
are, however. 


indicate how one might write an expanded 
to the assembler. The expansions may appear 
expansions produced by the assembler. They 
functionally equivalent. 


Sixbit File Representation 

Many of the System and I/O Macros have a "namptr" argument which points 

to a 3-word block of core in the user's program containing the sixbit 

representation of a file name and extension. This is simply an 

abbreviated form of ASCII in which the rightmost 6 bits of the ASCII 

code are used. This allows 3 characters to be packed in one word of 

storage. Sixbit packing can be accomplished either by the user 

program or by the MACRO-15 Assembler's .SIXBT pseudo-op. (Refer to 

the MACRO-15 Assembler Manual ic t***™ ^ 

—~——-~™s_ii£nuai (DEC-15-LMACA-B-D) . The example following 

paragraph 6.8.5 demonstrates the use of .SIXBT. 



5,2.2.1 


.PUT 


Creates a file which contains the current core image. 
The file's name and extension will be that found in 
the locations pointed to by namptr. See also .GET. 

MACRO-15 does not expand the .PUT Macro. The following 
FORMAT model illustrates how the user might 
formulate his own macro. The Resident Monitor, how¬ 
ever, does recognize the command illustrated in the 
EXPANSION section. 

FORMAT: 

. PUT *_jf, namptr, u 


ARGUMENTS: 




f = (function) determines the startup loca¬ 
tion for a .GET with f=4, 
or a GET Keyboard command 
to the Nonresident Monitor. 






f ~ 0 Subsequent load will start at the 
location following the EXPANSION. 

f = 1 Subsequent load will start at 
current CTRL P address 

f = 2 Subsequent load will start at 
current CTRL T address 

f = 3 Subsequent load will start at 
current CTRL S address 


namptr = Pointer to the address of a 3-word, 

.SIXBT representation of the name 
and extension of the file to be cre¬ 
ated (unused spaces must contain nulls). 

u = (unit) the unit number of the device as¬ 

sociated with .DAT-14 on which the 
desired file is to be placed. 

EXPANSION: 

LOC+0 CAL+f 

LOC+1 26 

LOC+2 U*lj3j9j2lj2fj2f+namptr \ 
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5.2.2.2 .GET 


Overlays core with, the contents of the file whose name 
is indicated by the Macro argument namptr. The file 
must have been created by a .PUT System Macro, or a PUT 
command to the Nonresident Monitor, and it must reside 
on the device associated with .DAT-14. .GET destroys 
the current contents of .SCOM, including DATE and TIME. 
See also the .PUT System Macro, and the PUT and GET 
commands to the Nonresident Monitor. 

MACRO-15 does not expand the .GET Macro. The following 
FORMAT model illustrates how the user might formulate 
his own macro. The Resident Monitor, however, does recog 
nize the command as illustrated in the EXPANSION section. 

FORMAT: 

. GET i_jf , namptr , u 


ARGUMENTS: 


f = (function) - determines startup location 
after overlay. 


f = 0 

f = 1 

f = 2 

f = 3 
f = 4 


Start at location after 
expansion of System Macro 
that created the file. If 
file was created via a .PUT 
command to the Nonresident 
Monitor, load core from the 
file, and await a command 
from the console keyboard. 


Start at CTRL P 
address 

Start at CTRL T 
address 

Start at CTRL S 
address 


Refer to 
the DOS-15 
System 
Manual for 
more 
informa¬ 
tion . 


Start at the location speci¬ 
fied by the .PUT System Macro. 
If the file was created via a 
PUT call to the Nonresident 
Monitor, load core, and await 
command from the console key¬ 
board. 


namptr = Pointer to the first word of a three- 

word .SIXBT representation of the file name 
and extension for the core image to be 
loaded. (Unused spaces must contain nulls.) 

u = (unit) The unit number of the device as¬ 

sociated with .DAT—14 on which the 
desired file is to be found. 

EXPANSION: 

LOC+jZ CAL+f 

LOC+1 25 

LOC+2 u*ljZjZjZjZ)Z+namptr 
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5.2.2.3 . GTBUF (Get Buffer) 

Requests a buffer from the buffer pool. If a buffer is 
available from the pool, the Monitor will return the ad¬ 
dress of the first word of the buffer in the AC. If no 
buffer is available, the Resident Monitor will return 
777777 in the AC. On return, execution begins at LOC+3. 
LOC+2 can be used as desired. This Macro gives user 
programs as well as handlers access to buffers. 

FORMAT: 




.GTBUF 


ARGUMENTS: 


none 



EXPANSION: 


LOC+0 CAL+0 
LOC+1 21 
LOC+2 0 


5.2.2.4 .GVBUF (Give Buffer) 

Allows a user to return to the buffer pool a buffer 
obtained via a .GTBUF System Macro. 

FORMAT: 

.GVBUF 

ARGUMENTS: 


None, at assembly time, but 

AT RUN TIME, the program must load LOC+2 with 
the address of the buffer to be freed. If LOC+2 
does not contain the address of an allo¬ 
cated buffer, the AC will contain 777777 
on return. 

EXPANSION: 

* LOC+0 CAL+0 

LOC+1 22 

LOC+2 0 (Load with first address of buffer) 
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5.2.2.5 .OVRLA 


Requests the System Loader to bring into core and start the 
core image system program whose name is pointed to by the 
Macro argument namptr. If there is not enough room in 
core to load the program requested, the Resident Monitor 
will return control to LOC+3. 


WARNING 

All I/O should be completed before 
issuing an .OVRLA. 


FORMAT: 


. OVRLAi^namptr 


ARGUMENTS: 


namptr = (name pointer) first address of the 
two-word .SIXBT representa¬ 
tion of the name and extension 
of the file containing the pro¬ 
gram to be brought in. 

EXPANSION: 


L0C+j2f CAL+0 
LOC+1 24 
LOC+2 namptr 




\ 


5.2.2.6 .EXIT 


Requests the System Loader to bring in the Nonresident 
Monitor. Current contents of core are lost. All un~ 
closed output files are destroyed, all input files are 
closed. 

FORMAT: 

.EXIT 

ARGUMENTS: 

none 

EXPANSION: 

LOC+,0 CAL+J2f 
LOC+1 15 
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5.2.2.7 .TIMER 


Allows programs to schedule routines to be called after 
specific time intervals. 


Refer to Chapter 2 of the DOS-15 System Manual 
(DEC-15-0DPFA-B-D) for programming rules for 
these routines. 


FORMAT: 


. TIMERunnnnnn, addres 


a 




ARGUMENTS: 

nnnnnn = (time interval) number (in decimal 
radix) of clock ticks from "now" 
after which the subroutine is to be 
called 

j2f < nnnnnn<_2 1 8 -l 

addres = address of the routine to be called 
after the specified number of ticks. 

EXPANSION: 

LOC+0 CAL+jZf 
LOC+1 14 
LOC+2 -nnnnnn 
LOC+3 addres 
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CHAPTER 6 


PROGRAMMED I/O COMMANDS 

6.1 INTRODUCTION 

This chapter describes the concepts, commands and methods for incorpora¬ 
ting input/output commands in MACRO-15 assembly language programs. 

FOCAL and FORTRAN users need not, irt general, be concerned with the 
contents of this chapter, since each of these languages has its own 
I/O capability. 

The DOS-15 IOPS is the interface between any program and the external 
world of I/O devices. I/O device handlers are provided for all stan¬ 
dard devices and are described in Chapter 9. These handlers relieve the 
user of the burden of I/O considerations and unwanted device dependence. 

6.2 GENERAL I/O COMMUNICATIONS 

Under DOS—15, all I/O transfers and subsidiary I/O operations are 
initiated by programmed I/O commands called I/O Macros, as shown in 
Table 6-1. These I/O Macros are macro instructions which have a .DAT 
j slot as one argument. As with System Macros, they are permanently 
defined in the MACRO-15 Assembler. 


As can be seen from 'Table 6-1, there are four I/O Macros within the 
DOS-15 Software System which effect data transfer: .READ, .WRITE, 

.RTRAN and .TRAN. The first three permit operation using the standard 
DOS file structures described in Chapter 4 and provide the most 
device independent approach to I/O programming. The .TRAN Macro func¬ 
tions independently of DOS-15 file structures. 



Table 6-1 


SYNOPSIS OF DOS-15 I/O MACROS 


Macro 

Function 

.CLEAR 1 

Initializes a directory on a directoried mass storage 
device. All data on the device is lost and fresh bit 
maps and directories are written. 

.CLOSE 1 

Terminates use of a file. In the case of output files on 
the disk, fills out the Retrieval Information Block (RIB) 
for later .RTRAN commands. 

.DLETE 1 

_ 

Deletes a file from a directory on a mass storage device. 

.ENTER 

Primes a directoried mass storage device to accept an out¬ 
put file. 

.FSTAT 

Checks the directory on a mass storage device for the 
existence of a named file. 

. IN IT 1 

Initializes the device and device handler. 

.MTAPE 

Provides special commands for industry compatible magnetic 
tape. 

.RAND 

Opens a disk file for random processing via .RTRAN macros. 

.READ 

Transfers a logical record, or the requested number of words, 
whichever is smaller, from the device to the user's I/O 
buffer. 

.RENAM 1 

Renames a file in a directory of a mass storage device. 

.RTRAN 

Allows input and output to access any block in a pre¬ 
existent file on the disk (any word if RF). 

.SEEK 

Checks for a named file in a directory on a mass storage de¬ 
vice. If the file is present, prepares it as an input file. 

.TRAN 

Gives independence from DOS-15 file structure by allowing in- ! 
put and output access to Magtape, or to any block on disk or 
DECtape located by its physical block number. A file can be 
opened for sequential or random access and still be .TRANed 
via the same .DAT slot without destroying the file structure. 

.USER 

Allows programs to change the .UFDT. 

.WAIT 

Waits for I/O already started to complete, then continues. 

.WAITR 

If I/O is complete execution continues. If I/O is 

not complete control is transferred to the specified address. 

.WRITE 

Transfers data from user's I/O buffer to the device. 


x At completion of these operations, the buffer is given back to the 
buffer pool, if disk or DECtape "A" version I/O handler. 





























6.2.1 .READ/.WRITE/.RTRAN Operations 


.READ and .WRITE Macros permit the user to sequentially input and out¬ 
put records of a file consisting of ASCII lines or binary data to any 
device in the standard set of PDP-15 I/O devices. The .RTRAN Macro 
provides the user with random access to physical blocks when using 
the disk devices. Initially, files are created sequentially (.WRITE) 
and can subsequently be accessed both sequentially (.READ) and 
randomly (.RTRAN). 

6.2.2 .TRAN Operations 

The last data transfer macro (.TRAN) functions only on mass storage de¬ 
vices. It provides I/O transfer capability at the device level with¬ 
out regard for established file structures. This type of transfer 
provides for user-designed file structuring. 

Much of the remainder of this chapter is devoted to I/O programming 
within the DOS-15 file structures and, specifically, to the methods 
and considerations involving the creation of sequential files. Little 
can be said here about the utilization of the .TRAN and .RTRAN Macros 
since the system places the burden of data structuring, interpretation, 
checking and packing on the programmer. 

6. 3 SEQUENTIAL FILE PROCESSING 

I/O operations under DOS consist of the transfer of ASCII or binary 
logical records between buffer areas in the system or user program 
and I/O devices represented by the device handlers in TOPS. (A logical 
record is defined as the amount of ASCII or binary data which is trans¬ 
ferred to or from a program as the result of the execution of a single 
.WRITE or .READ I/O Macro.) The size of each logical record depends 
upon the structure of the data (Data Mode) and the device or set of 
devices addressed. The format and data structure of each logical 
record output in IOPS and Image Data Modes is described below. For 
Dump Mode, however, no particular requirements are placed on the user 
by the system. Dump mode is provided to permit user-created data 
structures within the DOS-15 file structure. 

6.3.1 Logical Record Format, IOPS and Image Modes 

Each logical record to be output in IOPS and Image Modes must be 
formatted as shown in Figure 6-1. The record, consisting of 2n 
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18 bit words contains a two word, header (called header word pair) 
followed by 2n-2 words of ASCII or binary data. 



The header word pair is a communications link between the user's pro¬ 
gram and the I/O device handlers in IOPS. It is divided into various 
fields which contain information about the data which resides in the 
record. The information in some fields is supplied by the program to 
assist the device handlers in writing records and subsequently retriev¬ 
ing them. Other fields contain information which is provided by the 
device handlers for use by the user or system program when verifying 
records during input. Refer to paragraph 6.4.3 for explanation of Dump 
Mode record format. 


6 " 3 ’ 1 " 1 grader Word Pair Format - Figure 6-2 shows the format of the 
header word pair. Of particular significance is the Word Pair Count; 
it specifies the number of word pairs of data in each logical record. 
In addition, for all Data Modes except Dump Mode, it is the prime 
logical record terminating condition when using mass storage devices. 
This term should not be confused with the Word Count, which is an 
argument used in I/O Macros. The Word Count gives the actual size of 
the I/O buffer which contains the logical records prior to output and 
after input operations (see 6.7). 


6.3.1.2 Using the Header Word Pair 
A. Before Output 

The program must calculate and then set the appropriate word pair count 
m bits 1-8 of header word zero, unless they have already been set by 
a device handler on input (i.e., an input device handler set up the 
header word pair for each record read). This count overrides the word 
count passed to IOPS by the .WRITE system Macro. The I/O mode field, 
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bits 14-17, is set by the device handler from the I/O mode argument 
specified in the .WRITE Macro. The checksum word need not concern 
tfie user since checksums are computed by TOPS (when using IOPS Data 
Modes). 



Figure 6 — 2. Format of Header Word Pair 



The user need not be concerned with the header word pair since it will 
Be set up by the device handler during input to enable the user to 
determine the status of his record after input has terminated. 
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C. During Input 


The Word Count (specified in the .READ Macro) is used by the device 
handler to determine the maximum number of locations provided in the 
user s input buffer for the data being read. If the Word Count is ex— 
ceeded before the end of the record (as specified by the Word Pair 
Count) has been reached or if a parity or checksum error has occurred, 
the handler sets the validity bits of header word 0 as required to 
indicate the error. 


D. After Input 


Header word 0 of each logical record input should be examined by the 
user program to determine whether errors have occurred. Specifically, 
the validity and I/O Mode bits should be tested. If both checksum and 
parity errors are detected by a handler, priority is given to a parity 
error and the checksum error will not be indicated. IOPS ignores check™ 
sum errors on binary input if bit 0 of word 0 is set to 1. When exam¬ 
ining the I/O Mode Bits (bits 14-17) the occurrence of a buffer over¬ 
flow condition means that the user program's I/O buffer, as specified 
by the Word Count in the .READ Macro, is not large enough to contain 
the record just read. The portion of the record which caused the 
overflow is lost. In addition, IOPS uses the I/O Mode Bits to indi¬ 
cate that either the physical end-of-medium (EOM) or the logical 
end-of-file (EOF) has been reached; otherwise, these bits specify the 
Data Mode of the Record. 


6.4 DATA MODES 

The device handlers within IOPS allow data transfers via .READ and 
.WRITE Macros in one of the five Data Modes listed below: \ 


IOPS Binary 

(Mode 

0 ) 

IOPS ASCII 

(Mode 

2 ) 

Image Binary 

(Mode 

1) 

Image Alphanumeric 

(Mode 

3) 

Dump 

(Mode 

4) 


Data Modes permit the user to select the data structuring features of 
the system which are important to his application. The device independ¬ 
ent features of the system can be enhanced through the use of the IOPS 
Modes, which are standardly used by all DOS-15 System programs (e.g., 
both FORTRAN IV and MACRO-15 accept source programs in the form of IOPS 



ASCII files and product object code as IOPS Binary files). Conversely, 
if specific device dependent features are desired, Image Mode can be 
used primarily with non-mass storage devices, and Dump Mode can be 
used primarily with mass storage devices. 

6.4.1 IOPS Modes 

The IOPS Data Modes, both ASCII and Binary are the standard data struc¬ 
tures of the DOS Software System. Using these modes, all ASCII and 
Binary data input is verified and converted into standard records re¬ 
gardless of its original form on the input device. Before output, 
programs must format data into standard IOPS records. On output, IOPS 
calculates checksums and either reconverts the data to the form re¬ 
quired by the output device or, in the case of mass storage devices, 
stores the data in the standard record format. 

6 * 4 ’ 1 * 1 ? S ASCI1 “ I0PS ASCII is used by DOS-15 System 

Software as the standard ASCII Data Mode. It accommodates the entire 
7-bit ASCII (1968) 128 character set as shown in Appendix A. All 
alphanumeric data, whatever its original form on input (i.e., 8-bit 
ASCII, Hollerith, etc.) or final form on output, is converted 
internally by the non-mass storage device handlers and stored in 
core and on mass storage devices as "5/7 ASCII". This term refers 
to the internal packing and storage scheme used for IOPS ASCII 
in which five 7-bit ASCII characters are packed into two contigu¬ 
ous 18 bit words. Figure 6-3 shows this relationship. ASCII packed 


-->13 14-*—..-»-17 

1ST CHARACTER 

2ND CHARACTER 

3RD CHARACTER 

1-4 


3RD CHARACTER 
5-7 

4TH CHARACTER 

-—----— -—8» 16 

5TH CHARACTER 

17 


■UNUSED 


Figure 6-3 5/7 ASCII Packing Scheme 
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m this form can be stored "as is" on any mass storage device. I/O 
requests involving 5/7 ASCII should be made using an even word count 
argument to accommodate the paired data. ASCII data is ordinarily in¬ 
put or output character-by-character via non-mass storage devices such 
as teleprinter, line printer, paper tape reader and punch. It can 
also be stored on mass storage devices in 5/7 form (see Figures 6-4 
and 6-5). On paper tape an iops ASCII character is defined as a 7-bit 
character with even parity in the eighth (high order) bit, in keeping 
with USASCII standards. Further, IOPS performs a parity check on 

input, prior to the 5/7 packing and on output IOPS generates the cor- 
rect parity. 

Non-parity IOPS ASCII occurs in data originating at a Model 33, 35, 
or 37 Teleprinter, without the parity option. This data always appears 
with the eighth (high order) bit set to 1. Apart from parity checking, 

the IOPS routines handle IOPS ASCII and non-parity IOPS ASCII data identi¬ 
cally. 



Figure 6-4 IOPS ASCII on Paper Tape 



Figure 6-5 IOPS ASCII in I/O Buffers 
and on Mass Storage Devices 
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Each logical record is an alphanumeric line, and a Carriage Return (CR) 
or ALT MODE. CR (or ALT MODE) is a required line terminator in IOPS 
ASCII mode to non-mass storage. Unused character positions in the IOPS 
Word Pair after the CR or ALT MODE are ignored. Control character scan¬ 
ning is performed by some device handlers for editing or control purposes 
(refer to Chapter 9). 


On input, each IOPS ASCII .READ results in a 5/7 packed ASCII line being 
placed in the program's I/O buffer. If this line is to be interpreted, 
it must be unpacked by the program. Conversely, on output each .WRITE 
assumes that the data in the user's I/O buffer is. a 5/7 packed ASCII 
line. Thus, it is up to the program performing IOPS ASCII data trans¬ 
fers to unpack each input line and pack each output line. Appendix B 
contains assembly listings of generalized packing and unpacking routines 
which can be incorporated into user programs as required. 


6. 4 .i.2 IOPS Binary _ IOPS Binary data is blocked in an even number 
of words, with each block preceded by a two-word header (see Figure 
6-6) . On paper tape (see Figure 6-47) , IOPS uses six bits per frame, 
with the eighth channel always set 1 to 1, and the seventh channel con- 
taining the parity bit (odd parity) for channels 1 through 6 and 
channel 8. ‘The parity feature supplements the checksumming as a 
data validity provision in paper tape IOPS binary. 


WORD PAIR COUNT 
(INCLUDING HEADER WORD PAIR) 


HEADER 
WORD PAIR 


l PAIRS OF 18-BIT 
f BINARY WORDS 


15-0 651 


Figure 6-6 IOPS Binary in I/O Buffers and on Mass Storage Devices 


o t 


(4 17 


CHECKSUM 
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TAPE CHANNEL 


8 7 6 5 4 


3 2 1 



6.4.2 Image Modes 

Image Mode data, both Image Alphanumeric and Image Binary, is read, 
written and stored (on mass storage devices) in the form established by 
the source or terminal device. These modes permit the user to take 
advantage of the data structuring features peculiar to non-mass storage 
devices. These modes are strictly device dependent and no checking, 
packing or interpretation of data is performed. For example, when deal¬ 
ing with Alphanumeric data the teleprinter editing features RUBOUT and 
CTRL U, described in 9.3.1 are ignored, as well as the TOPS ASCII line 
terminators Carriage RETURN and ALT MODE. with the line printer, how¬ 
ever, Carriage RETURN and ALT MODE are accepted as legal line termina- 
tors. 


Image Alphanumeric Mode results in the transfer of all eight bits of 
an ASCII character to or from an I/O buffer (see Figures 6-8 and 6-9). 
Image Binary data is unchecksummed binary and appears on paper tape, in 
I/O buffers and on mass storage devices as shown in Figures 6-10 and j 
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Figure 6-9 Image Alphanumeric Data 

on Paper Tape 



Figure 6-10 Image Binary in I/O Buffers 
and on Mass Storage Devices 
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6.4.3 Dump Mode 


Dump Mode permits complete freedom in data structuring in the context 
°f a fils structured environment 1 . Data input or output in Dump Mode 
is not interpreted, checked or packed and record length is not limited 
by the software. Dump Mode is used to output from, or load directly 
into, any core memory area. All data transferred are treated strictly 
as 18-bit binary words (i.e., core images). No Header Word Pair is 
used. Each .READ or .WRITE statement in Dump Mode requires arguments 
which merely define the core starting address of the area input or 
output and the number of words (Word Count) to be transferred. Dump 
Mode is normally used with mass-storage devices although paper tape 
I/O is possible. With paper tape, data is interpreted on output or 
input as three six-bit frames per 18~bit word (see Figure 6-11)„ On 
input from paper tape, the 7 channel is ignored and the 8 channel must 
be punched in each data frame. This requirement is automatically met 
by the paper tape punch handler when output is in dump mode. 

6*4«4 Logical Record Terminators 


IOPS detects the end of each logical record transferred using a pre¬ 
defined group of terminators or terminating conditions. These logical 
record terminators vary with the Data Mode in effect, the particular 
device or set of devices involved, and the transfer direction (input 
or output). Table 6-2 summarizes the terminating conditions for logi¬ 
cal records during input and output for each IOPS Data Mode. Detailed 
information on terminating conditions for each I/O device handler 
is provided in Appendix C. 


^The .TRAN System Macro (paragraph 6.7.13) permits user specified 
He structuring as well as data structuring. A Dump Mode transfer 
can be thought of as effectively a file structured .TRAN. 



Table 6-2 


Logical Record Terminators 


Data Mode 

Input 

Output 

IOPS ASCII 

Carriage RETURN or ALT MODE 
Word Pair Count 1 

EOM 

Word Count 2 

EOF 1 

Carriage RETURN 

ALT MODE 

Word Pair Count 3 

IOPS Binary 

Word Pair Count 

EOM 

Word Count 2 

EOF 1 

Word Pair Count 

Image Alpha¬ 
numeric and 
Image Binary 

Word Pair Count 1 

Word Count 

EOM 

EOF 1 

Word Pair Count 

Dump 

Word Count 

EOM r ; - 
EOF 1 

Word Count 

_ 

1 Mass storage only. 

If word count is exceeded before a terminator is encountered, IOPS 
sets bits 12 and 13 of Header Word 0 to 3 (Buffer Overflow) 

If the Word Pair Count is 1 or less, the line is ignored; if greater 
than 1, ignore the count and accept Carriage RETURN or ALT MODE (non- 
file oriented devices only). Bulk storage devices require a word 

Pair Count greater than 1 and less than 177 0 ; otherwise an IOPS 23 
error will occur. y 
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6 • 5 I/O BUFFERS 


6.5.1 Space Allocation 

Each system or user program which is to perform I/O operations must 
allocate an I/O Buffer for each I/O device and unit (i.e., a .DAT 
slot) that is to be used simultaneously. This can be accomplished 
by, but is not limited to, one of the methods described below. 

Static buffer allocation can be accomplished through the use of the 
MACRO-15 Assembler's .BLOCK pseudo-op as described in (DEC-15--LMACA-B-D) 
A tag must be used to permit referencing of the buffer in each I/O 
Macro. For example: 


.DEC 

INBUF .BLOCK 52 

OTBUF .BLOCK 254 
.OCT 


/CREATES 52(10) WORD BUFFER 
/CALLED INBUF 

/CREATES 254(10) WORD BUFFER 
/CALLED OTBUF 


Dynamic buffer allocation can be performed through the use of the 
Monitor Macros .GTBUF and .GVBUF described in Chapter 5. Alternatively, 
the user can create a buffer at execution time from free core by simple 
calculation, using the information contained in the System Communica¬ 
tion Registers, .SCOM+2 and .SCOM+3 (absolute locations 102 and 103 
octal). These registers contain the lowest and highest addresses of 
the registers in unused core, respectively. 


6.5.2 Size Considerations 


When choosing a maximum I/O buffer size to specify in the Word Count 
arguments for .READ and .WRITE I/O Macros, both the set of possible 
devices and the Data Mode must be considered. As a general rule, 
when using IOPS and Image Modes, the maximum logical record size/an 
never exceed the maximum buffer sizes specified in Table 6-3. These 
are based on physical device limitations. In Dump Mode, however, there 
are no restrictions on buffer size except for the absolute bounds of 
core Itself; a logical record can occupy any number of physical blocks 
on a mass storage device. Programs which are to communicate with a 
number of devices using IOPS or Image Modes must limit the output 
buffer size to that of the device with the smallest buffer. 
Conversely, in setting-up input buffers, the size must be at least as 
large as that for the device with the largest buffer size. 



Table 6-3 


Maximum I/O Buffer Sizes for IOPS and Image Mode Transfers 




Device 

Max. Buffer Size 

Data Modes 

Comments 

Disk Cartridge 
(RK) 

254 

(376g) 

All 

IOPS and Image Modes 
permit more than one 

DECdisk (DK) 

254 

(376 8 ) 
(376g) 

All 

logical record (de- 

Disk Pack (DP) 

254 

All 

pending on its size) 
per physical block. 

DECtape (DT) 

255 

( 377 g) 

( 377 g) 

All 

Dump Mode records can 

Magtape (MT) 

255 

All 

span an unlimited num¬ 
ber of blocks. 

Teleprinter (TT) 

:: O- .3 4 

(42 8 ) 

IOPS ASCII 

Allows for 80 5/7 
packed characters 


74 


; . •••; • ; # •; • ; p: ‘' 

Image Alpha- 

(Allows for 72 char- 




numeric 

acters) 

Paper Tape 

Reader (PR) 

52 

(64 8 ) 

All 


Paper Tape 

Punch (PP) 

52 

(64 a ) 

All 


Line Printer 
LP-15/LP—11 

36 

(44 g ) 

IOPS ASCII 

Allows for 80 5/7 

(80 column) 

84 


Image Alpha- 

packed characters 
Allows for 80 




numeric 

characters 

j Line Printer 56 

1 LP-15/LP—11/LS-ll 

< 70 8> 

IOPS ASCII 

Allows for 132 5/7 

(132 column) 




packed characters. 


13 6 


Image Alpha- 

Allows for 132 




numeric 

characters 

Card Reader (CD) 
CR15/CR11 

36 

(44 8 ) 

IOPS ASCII 

Allows for 80 5/7 
packed characters plus! 
a handler supplied 
Carriage RETURN. 

VP15A Storage 

Tube Display 

34 

00 

CM 

-nF 

IOPS ASCII 

Allows for 80 5/7 




characters (only 72 
can be displayed) 



74 


Image Alpha- 

Allows for 72 

— —--- 



numeric 

characters 


Octal representation of buffer sizes i q eT, nun ^ n 

issuing a . INIT and indicatinrr fho m ■ boV ^ n f° r values returned after 

IOPS Modes. Other sizes Sown Sn S1Z ? Which ° an be used 

specified. h be used W1 th Image Modes as 
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For example: Consider the I/O buffer requirements for a program which 
must be capable of transferring IOPS ASCII lines to either a tele¬ 
printer or the DECdisk. The maximum I/O buffer size for the tele¬ 
printer is 34 1q locations and for the DECdisk is 254^^ locations. 
Therefore, the user should choose the smaller size since his program 
must deal with both. More importantly, if the ASCII records stored 
on the DECdisk were greater than 34 locations in length, the user 
could not transfer them back to the teleprinter without truncation 
or reformatting. 

6.6 SPECIFYING I/O DEVICES 

As mentioned in preceding chapters, the Monitor maintains a Device 
Assignment Table (.DAT), which has "slot" numbers that correspond di¬ 
rectly to logical device numbers. Each .DAT slot contains a pointer to 
a device handler and a unit number when applicable (for Disk Pack, 
DECtape or Magnetic Tape units). All I/O communication in the DOS-15 
Monitor environment is accomplished by the logical/physical device 
associations provided by the Device Assignment Table. 


When writing a MACRO-15 program which uses I/O Macros, it is neces¬ 
sary to incorporate the MACRO—15 Assembler's .IODEV pseudo-op somewhere 
in the program to specify to CHAIN or the Linking Loader which logical 
device numbers (.DAT slots) are to be used. The .IODEV pseudo-op 
causes the Assembler to generate a code in the object program which 
instructs CHAIN or the Linking Loader to load the device handlers as¬ 
sociated with the specified .DAT slots. 

For example. .IODEV 3,5,6 causes the device handlers assigned to 

.DAT slots 3, 5 and 6 to be loaded with the program issuing the pseudo¬ 
op . 

6.7 I/O MACRO DESCRIPTIONS 

The paragraphs which follow describe the function of the I/O Macros, 
the information to be provided by the user (arguments), and the assembly 
language expansion of each 1 . Either the I/O Macros or their assembly 
language expansions can be incorporated directly in MACRO-15 programs. 
Typical I/O command sequences are discussed in paragraph 6.8.4. 


1 Paragraph 
ing the I/O 


5.2.2 describes conventions and symbologv 
Macros. 


used 


in present- 
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6.7.2 


1 001005 
776773 

2 2005 
775773 


.CLEAR 


Initializes all bit maps and directories on the device. 

Eliminates all references to files in the directory of 
the device associated with the named .DAT slot. 

In order to avoid clearing a directory when its files are 
still in use, the directory is checked for open files. 

If there are no open files, the directory is cleared; 
otherwise, an IOPS 10 error message (file still active) 
results. 

.CLEAR may only be used under the MIC, to a system device 
because it will destroy the system. 


FORMAT: 

. CLEAR*_,[-] ds 

ARGUMENTS: 

ds= .DAT slot (octal radix) 

EXPANSION: (all values below are octal) 

LOC+0 CAL [-]ds&7 77 
LOC+1 5 


.CLOSE 

When directed to a .DAT slot used for input: Clears 
all flags related to that .DAT slot. This deactivates 
the .DAT slot, and another .INIT will be necessary 
to use the .DAT slot in the future. Any allocated buf¬ 
fer is returned. ' 

When directed to a .DAT slot used for output: Allows 
all associated output to finish, and then writes an 
end-of-file (EOF) 1/2 software indicator in the last 
header word pair. If the .DAT slot is associated with 
a directoried device, any earlier file of the same name 
and extension is deleted from the directory. Operation 
then continues as for input files (above). 

FORMAT: 


. CLOSE ^[-]ds 

ARGUMENTS: 

ds = .DAT slot (octal radix) 

EXPANSION: (all values below are octal) 

LOC+0 CALds&777 
LOC+1 6 

all except non-file structured magtape. 
Non-file structured magtape. 
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6.7.3 .DLETE 


Deletes a file from the directory of the device associated 
with the named .DAT slot. 

If the specified file cannot be found, the contents of 
the AC will be 0 on return. > 


FORMAT: 


.DLETE a_J -]ds,namptr 

ARGUMENTS: 

^■ s = .DAT slot number (in octal radix) 

namptr = Pointer to the address of the first of 3 

words containing the .SIXBT representation 
of the name and extension of the file to be 
deleted (unused spaces must contain nulls). 

EXPANSION: (all values below are octal) 

LOC+0 CAL+1000 &mJ [ -] ds&777 
LOC+1 2 
LOC+2 namptr 


6.7.4 .ENTER 


Initializes a directory for a new output file. The file 
will be placed on the device associated with the .DAT 
slot named as one of the parameters to the macro. Trans 
fers control to the Monitor error handler to print the 
appropriate error message if there is no available space 
in the file directory. 


FORMAT: 


.ENTERa_j[-]ds , namptr ,p 


ARGUMENT: 


ds - .DAT slot (octal radix) 

namptr = Pointer to the address of the first of three 
words containing the .SIXBT representation of 
the name and extension of the file to be crea¬ 
ted. (Unused spaces must contain nulls). 

P = Disk file protection code to be assigned. 
Possible values for p: 


1 - file is unprotected 

2 - file is WRITE protected 

3 - file is READ/WRITE protected 


If p is omitted, the default protection code 
established at system generation time is used. 
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EXPANSION: (all values below are octal) 

LOC+0 CAL+10j2fJ2f* Pl _,[-] ds&777 
LOC+1 4 
LOC+2 namptr 


6.1.5 .FSTAT 

Checks the status of a file in a directory. Ignored 
by non-directoried devices. The namptr parameter 
points to the name and extension of the file whose 
status is desired. On return, the AC will contain 
the first block number of the file, if the directory 
lists a file with the indicated name. The contents of 
the AC will be zero on return if the specified file 
is not on the device. It is recommended that program¬ 
mers use .FSTAT prior to executing .SEEK if they wish 
to retain program control when a file is not in the 
directory. 

Bits 0 through 2 of LOC+2 must be set to zero prior 
to the execution of the CAL. On return, these bits 
of LOC+2 will contain a code indicating the type of de¬ 
vice associated with .DAT slot ds. 

0 = non-directoried device 

1 = DECtape file structure 

2 = RF DECdisk file structure 

3 = RP Disk Pack file structure 

4 = Magtape 

5 = RK Disk Cartridge file structure 
FORMAT: 

. FSTAT ds , namptr 

ARGUMENTS: 

ds = .DAT slot bctal radix) 

namptr = Pointer to the address of the first 
of tnree words containing the .SIXBT 
representation of the name and exten¬ 
sion of the file (unused spaces must 
contain nulls). 

EXPANSION: (all values below are octal) 

L0C+j2f CAL-\-3000-] ds&77 7 
LOC+1 2 
LOC+2 namptr 
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6.7.6 .INIT 


Initializes a device and device handler. 

Programmers must give a .INIT prior to giving any 
I/O commands referencing the named .DAT slot. Any 
.DAT slot initialized via a .INIT must eventually 
be closed via a .CLOSE. 

The handler that services any .INIT will return (in 
LOC+3 of the expansion) the maximum size of the line 
buffer allowed for that handler. For example, DTA 
will return 377 (255 ) in LOC+3, and DKA will 

return 376 (254 1Q ) in LOC+3 of the expansion. 

FORMAT: 


. INIT i_j[-]ds,dd,restrt 


ARGUMENTS: 




ds = .DAT slot (octal radix) 
dd = Direction of data flow 


0 

1 


file will be an input file 
file will be an output file 


restrt — Restart address. Although restrt must 
be included, to avoid assembly time 
errors, it has meaning only for .INIT 
commands referencing .DAT slots assigned 
to the teleprinter. Foy P 

EXPANSION: (all values below are octal) 


‘St* 





L0C+j2f 

LOC+1 

LOC+2 

LOC+3 


CAL+dd* 1000 [-]ds&777 
1 

restrt 

0 (Handler will return maximum buffer 
size in LOC+3.) 


NOTE: Bits 5, 6 and 8 of L0C+j2f provide added 

information for the GRAPHIC-15 software, 
the line printer handler and the disk 
handlers. See the individual handler 
descriptions for more information. 

Bit 7 of L0C+j2f should always be 0. 
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6.7.7 .MTAPE 


Performs functions unique to industry-standard magnetic 
tape, 1 .e. , functions for non-directoried magnetic tape. 
Limited functions are also provided on DECtape and disk* 
(see Chapter 9). See descriptions of appropriate hand¬ 
lers for more information. 


FORMAT: 

.MTAPE Wral [-]ds,nn 

ARGUMENTS: 

ds = .DAT slot number (in octal radix) 

nn = code number of magnetic tape function 
or configuration: 

00 - rewind to load point 

02 - backspace record 

03 - backspace file 

04 - write end-of-file 

05 ~ skip record 

06 - skip file 

07 - skip to logical end of tape 

10 - 7-channel, even parity,200 bpi 

11 - 7-channel, even parity, 556 bpi 

12 - 7-channel, even parity, 800 bpi 

13 - 9-channel, even parity, 800 bpi 

14 - 7-channel, odd parity, 200 bpi 

15 - 7-channel, odd parity, 556 bpi 

16 - 7-channel, odd parity, 800 bpi 

17 - 9-channel, odd parity, 800 bpi 

EXPANSION: (all values below are octal) 

LOC+0 CAL+nn*1000 8a _j [-] ds&777 
LOC+1 7 

6.7.8 .RAND 

Opens a disk file for random access via .RTRAN macros. Returns 
the number of blocks in the file in LOC+3 of the expansion. 

FORMAT: 



• RAND 

u_»[-]ds,namptr 

ARGUMENTS: 


„ds = 

.DAT slot (octal radix) 

namptr = 

Pointer to the first word of a 3-word, 
.SIXBT_representation of the filename and 
extension of the file to be opened (unused 
spaces must contain nulls). 

EXPANSION: 

(all 

values below are octal) 


LOC+0 

CAL+5000 iUJ [-]ds&777 


LOC+1 

2 


LOC+2 

namptr 


LOC+3 

0 
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6.7.9 .READ 


Returns the next logical record to the user’s I/O buffer. 
If the record is longer than the user's I/O buffer, the 
handler will fill the buffer and the rest of the record 
will be lost. If the record is shorter than the user's 
I/O buffer, the handler will use only the part of the 
buffer it needs. The handlers use several indicators 
to determine the length of record. Appendix C, Input/ 
Output Data Mode Terminators, shows which handlers use 
what indicators for each data mode. 

Since I/O operations and internal data transfers may 
proceed asynchronously with computation, a .WAIT command 
must be used after a .READ command before the user at¬ 
tempts to access the data in his I/O buffer, or to read 
another line into it. ~ " 

The user should always check bits 14 through 17 of the 
first word of the I/O buffer for end-of-medium and end- 
°f — fil e conditions. In non—Dump modes, the user should 
also interrogate bits 12 and 13 of the first word of the 

I/O buffer to ensure that the record was read without 
error. 

FORMAT; 


.READa„j[-] ds ,m,buf add,wdc 


ARGUMENTS: 


ds - .DAT slot (octal radix) 
m = Data Mode, as follows: 


0 - Data Mode is IOPS Binary 

1 - Data Mode is Image Binary 

2 - Data Mode is IOPS ASCII 

3 - Data Mode is Image Alphanumeric 

4 - Data Mode is Dump Mode 

bufadd = address of user's I/O buffer 

wdc = word count (decimal radix), includ¬ 
ing the two-word header. wdc should 
equal the length of the buffer at 
bufadd. 


EXPANSION: (all values below are octal) 

LOC+/ CAL+m* 1JW [ - ] ds & 7 7 7 
LOC+1 10 
LOC+ 2 b uf add 
LOC+3 -wdc 
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6.7.10 .RENAM 


Renames a file (useful only with directoried devices) 
The old name and extension are pointed to by namptr; 
the new name must be located at namptr+3. The AC 
will be zero on return if the file specified at 
namptr cannot be found• 


FORMAT: 

. RENAMtjC -] ds , namptr 


ARGUMENTS: 


ds = .DAT slot (octal radix) 

namptr = pointer to the old name and exten¬ 
sion (new name is at namptr+3). 

(Unused spaces must contain nulls.) 

EXPANSION: (all values below are octal) 

LOC+0 CAL+200/ UJ [-]ds&777 
LOC+1 2 
LOC+2 namptr 

6.7.H .RTRAN 

Allows random access to blocks in a file opened via a 
.RAND I/O macro. Programmers may read or write into 
any block of a file, but may not change the length 
of the file. 

FORMAT: 


* RTRAN [ ]ds,d,relblk,buf add,beg,wdc 

ARGUMENTS: 

ds = .DAT slot (octal radix) 

d = direction: 

0 - direction is input 
1 - direction is output 

relblk = block number (octal radix) rela¬ 
tive to beginning of the file ... 
first block is block 1, etc. 

bufadd = address of I/O buffer in user's 
core space. 

beg = first physical word of physical block 

to be read or written-ignored for 

output to disk pack and disk cartridge; 
must be octal radix, 0<beg£375. 

wdc = number of words, starting with beg, to\ 
be read or written... ignored for output 
to disk pack and disk cartridge; must 
be DECIMAL radix, 0<wdcj< (253-beg) . 
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6.7.12 


EXPANSION: (all values below are octal) 


LOC+jZ 

CAL+4jZj0jJf 8 _ J [-]ds 

LOC+1 

2 

LOC+2 

d*4jZ0JW+relblk 

LOC+3 

bufadd 

LOC+4 

beg 


.DEC 

LOC+5 

-wdc 


.SEEK 


Opens a file for input on a directoried device. .SEEK 
is ignored by non-directoried devices. 

If the file is listed in the device's directory, the 
handler reads the first block of the file into a 
buffer. (A subsequent .READ will obtain the 
first logical record in the user's I/O buffer.) 

If the file is not listed in the device's directory, 
the handler will pass control to the error handling 
routine in the Monitor. If the user wishes to retain 
control In the case that the desired file is not in 
the directory, he should first issue an .FSTAT command. 

FORMAT: 


. SEEKajC -] ds ,namptr 


ARGUMENTS: 

ds = .DAT slot (octal radix) 

namptr = pointer to the three-word .SIXBT 

representation of the name and ex¬ 
tension of the file to be opened 
for input. (Unused spaces must be 
null-filled.) 

EXPANSION: Call values below are octal) 

LOC+jZ CAL u [ — ] d s & 7 7 7 
LOC+1 3 
LOC+2 namptr 




\ 


s 
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6.7.13 .TRAN 



Allows device-dependent, non-directoried input and out¬ 
put to any mass storage device. Users address such 
blocks by their physical locations. .TRAN should be 
followed by a .WAIT macro, to ensure that the transfer 
has been completed. 

FORMAT: 

. TRAN,_j[-] ds ,d,blknum,bufadd, wdc 

ARGUMENTS : 

ds = .DAT slot (octal radix) 
d = direction of transfer: 

0 " input,forward 

1 - output, forward 

2 - input, backward (DECtape only) 

3 - output, backward (DECtape only) 

NOTE: DECtape blocks must be read in the di¬ 

rection they were written in, in order 
to obtain meaningful results. 

blknum = block number (octal radix) of block 
at which to start input or output; 

I/O with word count larger than one 
block will continue with the next 
contiguous block; end of tape or 
disk will cause IOPS error. 

bufadd = address of I/O buffer; I/O buffer 
must be at least as long as wdc„ 

wdc = number of words to be transferred 
(decimal radix) 

EXPANSION (all values below are octal): 

LOC+0 CAL+dnjWu^M dsS777 

LOC+1 13 

LOC+2 blknum 

LOC+3 bufadd 

LOC+4 -wdc 


i 
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6.7.14 .USER 


Allows users to dynamically assign UIC's to desired UFDT 
slots, thus permitting access to UFD's other than the UFD 
specified at LOGIN time (refer to paragraph 8.4). Protec¬ 
tion for the specified UFD and its files remains in ef¬ 
fect. .USER must be issued before the .INIT of the I/O 
sequence for which UFD change is desired (see example 
below) . 

FORMAT: 


.USERds ,uic 

ARGUMENTS: 


ds - .UFDT/.DAT slot number (octal radix) 

uic = (UIC) the .SIXBT representation of the 
three-character User Identification 
Code 

EXPANSION: (all values below are octal) 

LOC+0 CAL - ] ds & 7 7 7 
LOC+1 23 
LOC+2 uic 


For example: 

.USER 1,ABC 
.INIT 1 
.USER 1,CDE 

.SEEK 1,FILE 

.CLOSE 1 


This .SEEK searches for FILE under the 
UFD called ABC. 


.INIT 1 
.SEEK 1,FILE 


This .SEEK searches for FILE under the| 
UFD called CDE. j 
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6.7.15 .WAIT 


Obtains and holds control until the user's I/O buffer is 
available after an I/O operation. Should be used be¬ 
fore accessing an I/O buffer after .READ, .WRITE, .TRAN, 
and .RTRAN commands. 

FORMAT: 

.WAIT^jM ds 

ARGUMENT: 

ds = .DAT slot (octal radix) 

EXPANSION: Call values below are octal) •• •= 

LOC+0 CALds & 777 1 
... LOC+1 .12 .. ■; . 


6.7.16 .WAITR 

Returns control to the address specified as an argument 
to the CAL, if I/O is not complete. If I/O is com¬ 
plete, returns control to the next location after the 
macro expansion. It is the user's responsibility to re¬ 
turn to the .WAXTR command, or do another one. 

FORMAT: 

. WAITR [ —] ds ,waitad 

ARGUMENTS: 

ds = .DAT slot (octal radix) 

waitad = address to which control will be 
returned, if I/O is incomplete. 


>is,' EXPANSION: (all values below are octal) 

r is- 

LOC+0 CAL+ 1000 u[-]ds & 777 
LOC+1 12 
... LOC+2 waitad 
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6.7.17 .WRITE 


.WRITE transfers a logical record from the user's I/O 
buffer to the handler’s buffer. 

The .WRITE command establishes the mode in which data is 
transferred. The Header Word Pair Count determines the 
maximum amount of data to be transferred in all modes 
except Dump, which references the "wdc" argument. 

The only limits on data transferred in Dump Mode are 
the size of core and the capacity of the device accept¬ 
ing the data. On physically blocked devices, such as 
DECtape and disk, the handler will start from its 
current position in a block and fill successive 
blocks until the transfer is complete. If a Dump Mode 
transfer does not completely fill the last block used, 
a subsequent Dump Mode transfer will fill that block, 
before using any other. 

.WAIT or .WAITR must be used after a .WRITE command, 
before the user's I/O buffer is used again, to ensure 
that the transfer to the device has been completed. 

FORMAT: 


.WRITEds ,m,buf add,wdc 
ARGUMENTS: 

ds = .DAT slot (octal radix) / 9c" /-/!? 

Cf 0 ^ 

m = data mode for transfer 

$ - IOPS Binary 

1 - Image Binary ._' ' 4 

2 - IOPS ASCII .■ „ 

3 - Image Alphanumeric ^ < r/w/v 0 ' t *' 

4 - Dump 

bufadd = address of user's I/O buffer containing 
data to be transferred. 

wdc = word count, number of words to be trans¬ 
ferred (decimal), (relevant for Dump 
Mode transfers only). 

EXPANSION (all values below are octal) 

LOC+j? CAL+m* 1JW ^(- ] ds & 7 7 7 
LOC+1 11 
LOC+2 bufadd 
LOC+3 -wdc 






S 
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6.8 USING I/O MACROS 

The programmer must observe certain conventions when incorporating I/O 
Macros into a program. In general, consideration must be given to: 

• The physical device and its capabilities 

® I/O device handler characteristics 

© The I/O Macro Syntax 

© The I/O Macro Sequence for the desired file access/ 

structure (see Chapter 4) 

6-8.1 Physical Device Capabilities 

The considerations involved here are obvious and need little comment. 
Simply stated, the user must understand the gross differences between 
various devices. For example, a.READ cannot be issued to a line 
printer. Similarly, binary data cannot be output to a teleprinter. 

6.8.2 Device Handler Characteristics 

Many of the standard PDP-15 I/O devices available to DOS-15 users are 
provided with several handler versions. These versions vary from one 
to another as to the I/O Macros and Data. Modes which are acceptable to 
them. Some versions permit the full set of I/O Macros and Data Modes 
to be used, while others incorporate a subset of these features. These 
limited capability handlers are provided primarily for use where core 
allocation is a problem, since they are smaller than those with 
greater capability. The user must be aware of these handler differ¬ 
ences, particularly if he wishes to utilize device dependent charac¬ 
teristics. Detailed descriptions of the DOS-15 device handlers are 
provided in Chapter 9. 

6.8.3 I/O Macro Syntax 

The order in which I/O Macros are used is important to the success of 
an I/O transfer. There are basic rules of syntax which must be ad¬ 
hered to in order to avoid run time I/O (IOPS) errors. These rules 
apply to any I/O sequence directed to the same .DAT Slot. 

1. .INIT must always be issued before any other I/O 

Macro. It initializes the handler associated 
with the referenced .DAT slot for either input or 
output. Subsequent .INITs can be used to uncon¬ 
ditionally terminate an unwanted I/O operation. 
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2. .CLOSE (or .MTAPE Rewind, for Magtape) must always 

be the last Macro issued in the sequence. It termin¬ 
ates the current I/O operation and use of the asso¬ 
ciated .DAT slot. Another .INIT must be issued if 
subsequent transfers are to be made via this .DAT slot. 

3. I/O transfers to directoried devices (Disk, DECtape or 
Magtape) require the use of .SEEK before .READ, .ENTER 
before .WRITE and .RAND before .RTRAN. 


4. Intermixing of .SEEK, .ENTER, .MTAPE, and .RAND 
Macros in the same I/O sequence (i.e., occurring 
between an .INIT and a .CLOSE referencing the same 
.DAT slot) is illegal. 


The acceptability of specific combinations of I/O Macros is shown in 
Table 6-4. 


8 " 4 Selecting an I/O Macro Sequence 

The user has the capability of selecting command sequences which empha 
size either device independence or device dependence, as his needs 
dictate. Much of the device independence of the DOS-15 System is ob¬ 
tained by using I/O Macro sequences which are general enough to be 
acceptable to a wide range of device handlers. These sequences are 
based on sequential file access via the .READ and .WRITE I/O Macros, 
which are recognized by all DOS-15 Device Handlers. Simply by using 
.INIT - .READ (or .WRITE) - .CLOSE sequences along with the applicable 
IOPS Data Modes, a user's program has the capability of communicating 
with all non-mass storage devices (including teleprinter, paper tape 
reader and punch, line printer, card reader and VP-15 display). By 
adding the .FSTAT, .SEEK, and .ENTER Macros, the same program can, 
in addition, utilize the system's mass storage devices (including 
Disk, DECtape and Magtape)„ The examples below further illustrate 
these sequences. * 

Example 1 - Typical Output Sequence 

.IODEV 2 /Use .DAT slot 2 

,INIT 2,1,RSTRT /Initialize .DAT slot 2 for output (1) 


Optional check for existing file and 
device type, e.g., .FSTAT, .RENAM, 

.DLETE, etc. 




Example (cont'd) 


Process data for output 


.ENTER 2,NAME 



BUFF .BLOCK 42 


/Output a record to .DAT slot 2 
/from BUFF in IOPS ASCII Mode. 

/Wait till buffer is free 


/File name in .SIXBT 

/Spaces are null filled (i.e., @=null) 
/I/O buffer 




Example 2 - Input Sequence 
.IODEV 1 

t 

.INIT 1,0 ,RSTRT 


/Use .DAT slot 1 

/Initialize .DAT slot 1 for input (0) 


Optional check for exist¬ 
ing file and device type 
(e.g., .FSTAT, .RENAM, 
and .DLETE Macros). 


SEEK 1,NAME 



NAME 

BUFF 


.SIXBT 
.BLOCK 42 


"FIL@@@SRC" /File name in .SIXBT. Spaces are 
/null filled (i.e., @=null) 

/I/O buffer 
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Device dependent I/O programming is based in large part on the use of 
device-specific I/O Macro sequences and to a lesser degree on the struc¬ 
ture (Data Mode) of the data. For examples .RTRAN can only be 
used with disk handlers; non-mass storage devices do not need .SEEK 
or .ENTER for operation (they ignore them). Furthermore, the inter¬ 
pretation of data using the Image and Dump Data Modes becomes the 
user's responsibility, rather than the handler's. The user who does 
not need device independence can eliminate unnecessary instructions 
in his program and obtain additional free core for other purposes. 

For instance, assume that in the previous examples a directoried device 
was never to be used. The programmer could then economize by eliminat¬ 
ing all I/O Macros associated with I/O on directoried devices such as 
.SEEK, .ENTER, .CLEAR, .DLETE, .FSTAT. 

Figure 6-12 shows the relationship between standard I/O Macro sequences 
and the various I/O devices and file structure/access features of the 
DOS-15 system. Except for .INIT and .CLOSE, there is no implied order 
to the macros in any particular I/O sequence shown (the reader should 
refer to paragraphs 6.7 and 6.8.3.1 for this information). 

6.8.5 Programming Example 

The following example illustrates the use of I/O Macros in a Macro-15 
Assembly Language program. The program accepts an ASCII line from the 
teleprinter keyboard, creates a file on the disk (or if the .DAT slot 
is properly assigned, on any other directoried device), reads the file 
back from the disk, and prints it on the teleprinter. Before subse¬ 
quent keyboard inputs, the program prints the following message on 
the teleprinter: 

FILE ALREADY PRESENT!! 

DO YOU WISH TO KEEP IT? (Y OR N AND CR). 

> 

b Y typing a Y on the keyboard, the file previously created is saved 
and a new file is created for the next line input from the keyboard. 

By typing an N rather than a Y, the next line input from the keyboard 
is written on the disk using the filename associated with the line 
previously typed (that line will be deleted). 

The name of the file is initially ECHO 001. a new file name is 
created each time a Y is typed in response to the above message by 





Figure 6-12 

I/O MACROS APPLICABLE TO SPECIFIC DEVICES AND DATA ACCESS TECHNIQUES 
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incrementing the location in the program called NAME+2 which initially 
contains the "001" extension of the file name in Sixbit trimmed ASCII 
C.SIXBT pseudo-op). This produces a series of uniquely named files 
Cone each time a Y is typed) as follows: ECHO 001, ECHO 002, ECHO 003, 
ECHO 004, etc. 


The arguments used by the I/O Macros in this program are given symbolic 
names by means of MACRO-15 direct assignment statements at the begin¬ 
ning of the program. These names permit the programmer to change the 
real values of these arguments readily and also facilitate recall. 

The listing shown below is the source listing and is followed by an as¬ 
sembly listing which shows how Macros are expanded at assembly time. 

The reader may wish to compare these expansions with the Macro descrip¬ 
tions in the beginning of this chapter. 


Programming Example - Source Listing 



.title 

DKF.CHO 

3 IS K = 7 
TTI *6 
TT0 = 5 

I N = 0 



OUT-si 



I0PS=2 

. I0DFV 

5,6,7 

BEG I N 

. I NIT 

DISK,OUT,RESTRT 


. I NI T 

TTI,IN,RESTRT 


. INIT 

TT0,OUT,RESTRT 

START 

.fstat 

sha 

DISK,NAME 


JMP 

UPDATE 

READKB 

.write 

T TO, I0P-S,MSG3,34 


.«EA0 TTI,I0PS,BUFFER, 34 

/WAIT TTJ 

.EJECT 

LAC UQ5W 

SZ-A 

JM.P NF.WF1L 

WKITF , E N T F R DISKiNAME 

.WRITE DISK,I OPS»BUFFER,34 
.WAIT DISK 
.CLOSE HISK 

REAQ0T ,'INIT DISK,IN,RESTRT 

,'SEEk DISK,NAME 
,'RFA-D DISK, I OPS, BUFFER, 34 
.WAIT DISK 
.eject 

.write TTn,I0PS,BUFFER,34 
.WAIT T T 0 
.CLOSE T T 0 
.CLOSE TTI 
.CLOSE DISK 
JMP BEGIN 
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/INITIALIZE DISK OUTPUT, 

/teletype input, 

/AND TELETYPE OUTPUT 
/is file PRESENT? 

/NO, INPUT KEYBOARD 
/YES, OUTPUT MSG1 AND MS'C'2 
/TYPE A GO AHEAD SYMBOL <>> 
/INPUT InPS ASCII FROM KFYbOARD 
/WAIT UNTIL INPUT COMPLETE 

/test update switch 

/0 BEPLACE INPUT FILE 

/«»1 S SAVE INPUT; CREATE ,\iE w QijTPT 

/CREATE NEW DISK FILE 

/OUTPUT DATA ON DISK 

/WAIT UNTIL OUTPUT COMPLETED 

/close file 

/initialize disk input 
/LOCATE file "name" 

/read into buffer 
/WAIT UNTIL read complete 

/OUTPUT TO TELETYPE 

/WAIT UNTIL OUTPUT COMPETE 

/TERMINATE TELETYPE OUTPUT, 

/TELETYPf input, 

/ANU DISK INPUT/OIJTPUT 
/LOOP FOR UPDATE OPTION 


RESTRT 



Programming Example - Source Listing (Cont.} 


UPDATE 

.write 

TTO,IOPS.MSG1 


.wait 

.EJECT 

T T 0 


.write 

TTO , IOPS.MSG2 


.wait 

TTO 


.read 

IT I » IOPS.COM, 


.WAIT 

TTI 


L. A C 

C 0 M + 2 


AND 

(774000 


SAD 

(544000 


jMP 

YES 


DHm 

U D S W 


JMP 

reaqkb 

YES 

CLC 



DAC 

U D S W 


JMP 

READKB 

mewfil 

LAC 

M A M E ♦ 2 


lrs 

RTR 

PAR 

3 


lRS 

RTR 

BAR 

3 


us 

6 


AND 

( 777 


TAD ¥ 

(1 


LRS 

RTL 

6 


ral 



lls 

rtl 

ral 

3 


lls 

3 


and 

(070707 


XQR 

(606060 


DAC 

N A M E + 2 


jMR 

WR I TE 

MSG1 

MSG2-MSG1 /2*l(?Pe 

( 7 , 


.ASCII " 

file already " 


.ASCII " 
.eject 

PRESENT J|"< 15 > 

M$G2 

MSG3-MSG2/2#iD00 


71 


.ASCII "no YOU WISH TO KEEP IT ? 
.ASCII "(Y OR M aNU CR> >"<175> 


M S G 3 

COM~msg3/2*1000 

fA 

.ASCII ” > " < 17 5 > 

COM 

.block ie 

BUFFER 

.block a2 

N A M E 

,SIXBT "ECHO @@001” 

MOS U ! 

.END begin 


/OUTPUT mSGI 
/ANU MSG? 

/ON 

/teletype* 

/read RESPONSE 

/WAIT UNTIL READ COMPLETE 

/GET FIRST WORD 

/save first SEVEN BITS 

/IS char a y? 

/NOf SET TO REPLACE INPUT FILE 
/LOOP TO READ KEYBOARD 
/SET UPDATE SW, TO SAVE 
/INPUT, CREATE NEW OUTPUT 
/LOOP TO READ KEYBOARD 
/CHAnjGE EXT 

/least significant digit of 
/sixer value of last char in ext 
/strip off high PART of code 

/least significant digit of 
/ s i x bt value of middle char in ext 
/STRIP OFF HIGH Part of SlXBT code 

/put back in ac 

/STRIP or HIGH ORDER part of REMAINING 

/sixbt code for last ext char 

/INCREMENT TO MAKE NEW fxT 
/REVERSE PROCESS to FIX [JP EXT IN 
/PROPER SIXBT 


/to create new qut p ut 
/ wpc for header word 0 


/WPC FOR HEADER WORD 0 
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Programming Example - Assembly Listing 
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Programming Example - Assembly Listing (Cont. 
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6.8.6 File Integrity Considerations 

In a system such as DOS-15, which offers a flexible I/O command reper¬ 
toire, I/O programming requires care... otherwise, numerous IOPS errors 
may result. Further, there are I/O sequences which the system allows., 
which, if carelessly used, can result in the destruction of the user's 
files or those of others. The paragraphs below describe some important 
considerations. 

a. Extreme care must be exercised when using the .TRAN macro to 
output to the DECdisk, Disk Cartridge, Disk Pack, DECtape or 
Magtape® The user must know the disk and DECtape file struc¬ 
tures completely, because .TRAN operates completely outside 
these file structures, and ignores the existence of all direc¬ 
tories and bit maps® The entire contents of the disk or DECtape 
or Magtape, therefore, are vulnerable to the user of .TRAN® 

b. Caution should be used when reading a file from the disk se¬ 
quentially (.READ) from one DAT slot, while modifying the 
same file via another .DAT slotusing random access (.RTRAN). 

c. Generally speaking, output files are not recognized by the 
system until they are .CLOSEd. Under most circumstances, 
termination of program control and return to the Monitor 
will cause the Monitor to delete any unclosed output files. 
Occasionally, a system crash or other unusual phenomenon 
will cause a disk output file to be truncated. Truncated 
files are the remains of output files that the system did 
not get a chance to delete. Directory listings from PIP 
that contain an asterisk (*1 after a file name indicate a 

\ truncated file. They take up disk space and should be 
deleted via commands to PIP. 
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CHAPTER 7 
SYSTEM INITIALIZATION 

7.1 INTRODUCTION 

This Chapter describes the procedures to be followed when loading, 
starting, and tailoring the DOS—15 Software System. Under normal 
circumstances, these procedures should rarely need to be used. Oc¬ 
casionally, however, a program may enter a runaway condition which 
could result in the inadvertent destruction of a part of the DOS-15 
software residing on the system device or in core. In addition, it 
may be necessary to change the DOS—15 software configuration from 
time to time to permit the use of a new I/O device or system program. 
These alterations to the system may be performed only by those who 
have access to the system's Monitor Identification Code (MIC). Thus 
the average user need not be concerned with the contents of this 
chapter except as regards the loading and use of the DOS-15 Bootstrap 
(Paragraph 7.3.2). 

Chapter 10 contains the operating procedures to be used once the 
system is loaded and running. 

7.2 HOW THE SYSTEM SOFTWARE IS SUPPLIED 

The DOS-15 Monitor and System programs are supplied to users on either 
DECtape or Magtape, depending upon the particular hardware configura¬ 
tion. The bulk of the software system resides on the DECtape or Mag¬ 
tape medium in a special form which is meaningful only to the DOSSAV 
program, which can transfer the system to the disk. Thus, these tapes 
are often called "disk restore tapes" as they may be used only for 
this purpose. 

There are three binary kits for DOS-151 one for each type of system 
disk. The installation and loading of this software is described in 
the SGEN—DOS Manual (DEC-15-USGNA-A-D). 

DOS-15 on the RF15/RS09 DECdisk ; 

A. Papertape Utilities 

DOSSAV (Disk Save/Restore) 

RFBOOT (RF15 DECdisk Bootstrap) 

RF.CHK (RF15 Checkout Package) 
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A. Papertape Utilities (Cont.) 

ABSLll (PDP-11 Loader)* 

PIREX (UC15 Executive)* 

MAC11.IMG (3 Tapes of MAC11 Assembler)* 

B. Magnetic Tapes 


DECtape 


or 


7 or 9 Track Magtape 


2 Disk Restore 
DECtapes 

1 <PER> UFD 
DECtape 


1 Disk Restore 
Magtape 

1 <PER> UFD 
Magtape 


1 Floating Point 
FORTRAN DECtape 

1 UC15 Software 
Option DECtape* 

DOS-15 on the RP15/RP02 Disk Pack; 


1 Floating Point 
FORTRAN Magtape 

1 UC15 Software 
Option Magtape* 


A. Papertape Utilities 


DOSSAV (Disk Save/Restore) 

RPBOOT (RPJZ(2 Disk Pack Bootstrap) 

RP.CHK (RP02 Checkout Package) 

ABSLll (PDP-11 Loader)* 

PIREX (UC15 Executive)* 

MACH. IMG (3 Tapes of MACll Assembler)* 

B. Magnetic Tapes 


DECtape or 

2 Disk Restore 
DECtapes 

1 Floating Point 
FORTRAN DECtape 


7 or 9 Track Magtape 

1 Disk Restore 
Magtape 

1 Floating Point 
FORTRAN Magtape 


1 UC15 Software 
Option Magtape* 

DOS-15 on the RK15/RK05 Disk Cartridge ; 


1 UC15 Software 
Option DECtape* 


A. Papertape Utilities 

DOSSAV (Disk Save/Restore) 

RKBOOT (RK05 Cartridge Disk Bootstrap) 
RK.CHK (RKJ2f5 Checkout Package) 

ABSLll (PDP-11 Loader) 

PIREX (UC15 Executive) 

MACll.IMG (3 Tapes of MACll Assembler) 



"""N. 




*Note: 


Used with Configurations having a UC15 as a non-system device """% 

controller. o ? 
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or 


B. Magnetic Tapes 

DECtape , 

8 Disk Restore 
DECtapes 

1 Floating Point 
FORTRAN DECtape 


7 or 9 Track Magtape 

1 Disk Restore 
Magtape 

1 Floating Point 
FORTRAN Magtape 


7.3 SYSTEM STARTUP PROCEDURES 

The following paragraphs describe the procedure for loading and start 
ing the DOS-15 Software System using the DOSSAV and DOS-15 Bootstrap 
programs. 


7.3.1 Disk Restoration (DOSSAV) 


The DOS-15 Software System is transferred from the Disk Restore DEC- - 
tapes or Magtapes supplied by Digital Equipment Corporation to the 
appropriate disk device using the DOSSAV utility program. This program 
provides users with the ability to save and subsequently restore all 
occupied blocks on the disk using either DECtape, Magtape, DECdisk, 

Disk Cartridge, or Disk Packs as the storage medium. Though the pro¬ 
gram is most often used to install the DOS-15 System, it can also 
make additional copies of the system currently on the disk, of a newly 
tailored system (i.e., after System Generation), or of the contents 
of Disk Pack or Disk Cartridge units 1-7 (in the case of multiple 
Disk Pack, Disk Cartridge systems). 

DOSSAV operates interactively via the console teleprinter and asks the 
user a series of questions to determine which devices and unit numbers 
are to be used and, for Magtape, parity, density and track count in¬ 
formation. When all necessary information has been obtained, DOSSAV 
automatically begins the specified operation. If a save or restore 
operation requires more than one tape, the program stops and outputs 
a message on the teleprinter to that effect. The user can then mount 
the next tape and continue. The program performs error checking to 
detect both hardware and command string errors and output appropriate 
messages on the teleprinter. RUBOUT and CTRL/U are permitted when 
answering questions. 
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In addition, the program permits DECdisk users to restore systems 
created in a small DECdisk configuration to an environment with a 
larger DECdisk configuration. The reverse situation, however, is not 
possible. The DOS-15 Disk Restore tapes supplied by Digital for a 
one-platter system configuration, therefore, can be restored to any 
size DECdisk system configuration 1 . DOSSAV is a stand-alone program 2 
supplied in paper tape form and is loaded via the high speed paper 
tape reader using PDP-15 1 s Hardware Readin Mode (load address 37120 , 
restart address 34200). 

7>3.1.1 Operating Procedures - The following procedures should be 
used when restoring or saving the DOS-15 System Software (or other user 
created data on Disk Pack or Disk Cartridge units 1-7): 

For UC15, RK based systems 3 refer to Note 1 (page 7-5) for the 

PIREX start up procedures. 

a. Place the DOSSAV paper tape in the Paper Tape Reader. 

b. Set the console ADDRESS Switches to 37720. 

c. To restore the disk: 4 

1) Mount the DOS—15 Disk Restore DECtape or Magtape for the 
appropriate hardware configuration (i.e., DECdisk, Disk 
Pack, Disk Cartridge, Floating Point or non-Floating 
Point hardware) on the applicable tape drive. 

2) Set the DECtape drive WRITE ENABLE/LOCK switches to LOCK. 
(Magtape users should remove the Write Enable ring from 
the tape reel.) 

3) Set the disk READ/WRITE PROTECT switches to ENABLE. 

d. To save the contents of the disk: 

1) Mount a fresh tape on the appropriate tape drive. 

2) Set the DECtape WRITE ENABLE/LOCK switch to ENABLE.(Mag¬ 
tape users should install the Write Enable ring on the 
tape reel.) 


This type of operation should only be done with master tapes (or 
copies of them) since block 1775 fi must not be occupied when perform¬ 
ing a restoration to a system with 5 or more platters. 

For non UC15 systems only. PIREX has to be running for UC15, RK based 
systems; refer to Note 1 on page 7-4. 

^If PIREX is not running. 

Spooling must be disabled during any DOSSAV operations. 



e. Set the tape drive unit number switches as desired. ' 

f. Set all ON LINE/OFF LINE switches of the devices being used 
to ON LINE. 

g. Press the PDP-15 Console Switches STOP and RESET simultaneously, 
then press the READIN switch. (The DOSSAV tape should pass 
through the reader.) 

7.3.1.2 Commands - Once the paper tape has been read in, DOSSAV will 
identify itself on the teleprinter and begin to ask the user a series 
of questions about the devices to be used, as shown in Table 7-1. 

Each user response must be terminated by a Carriage RETURN. It should 
also be noted that some of the questions shown are typed out only 
when applicable (i.e., no questions are asked about Disk Pack unit 
numbers or Magtape parity, density, or number of channels if these 
devices are not to be used). Legal input and output device combina¬ 
tions are shown in Table 7-2. 

Note 1: LOADING PIREX 

It is assumed that the system cartridge is running on unit 0. Halt 
the PDP-11 .by pressing the ENABLE/HALT console switch down. Stop the 
PDP-15 by pressing the STOP toggle. On both machines the run light 
should be off. Set the PDP-15 address switches to 17700 (octal). 

(White line shows on bottom of 'on* bit.) Place the ABSL11 paper tape 
in the PDP-15 paper tape reader. Press both the STOP and RESET switches; 
simultaneously and then the READIN switch on the PDP-15 console. The 
paper tape should read in, and the PDP-15 should halt (RUN light off). 

Place 100000 (switch number 15 is up) in the address switches of the 
PDP-11. This assumes an 8K local memory? for 4K use 60000 and for 
12K use 120000. (Note that a bit is 'on* when the corresponding 
switch is up.) Press down the LOAD-ADDRESS switch. Move the ENABLE- 
HALT switch to ENABLE (up) . Press down the START switch. At this 
point the PDP-11 should start (RUN light should come on). 

Place the PIREX paper tape in the PDP-15 paper tape reader and then 
press the CONTINUE toggle on the PDP-15. The PIREX tape should read 
in, and the PDP-15 should halt. The PIREX monitor in the PDP-11 
should start (RUN light on, and bit 0 of the address lights on). This 
is the characteristic pattern of the PIREX null job. 
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Table 7-1 
DOSSAV Commands 


Query 

User Responses 

INPUT DEVICE? 

DT = DECtape, MT = Magtape, DK = DECdisk, 

DP = Disk Pack, RK = Disk Cartridge 

UNIT NO? 

Legal unit numbers are 0-7 

TRACK (7 OR 9) ? 

Magtape track or channel number. (If 9 is 

specified, density is assumed to be 800 BPI.) 

DENSITY 1 (2,5,8)? 

Magtape recording density: 2=200 Bits Per 

Inch (BPI), 5=556 BPI, 8=800 BPI. 

PARITY 1 (E OR 0)? 

Magtape parity scheme: E = even parity, 

0 = odd parity. 

OUTPUT DEVICE? 

(See INPUT DEVICE above.) 

UNIT NO? 

(See UNIT NO. above.) 

TRACK (7 OR 9)? 

(See TRACK above.) 

DENSITY (2,5,8)? 

(See DENSITY above.) 

PARITY (E OR 0)? 

(See PARITY above.) 

DATE CREATED: 

The date that the restore tape was created 
is typed out by DOSSAV. 


Table 7-2 

Legal DOSSAV I/O Device Combinations 


^InpuL^" 

Device 

Output 

^^evice 

DEC¬ 

disk 

(DK) 

Disk 

Pack 

(DP) 

DEC¬ 

tape 

(DT) 

Mag¬ 
tape 1 

(MT) 

Disk 

Cartridge 

(RK) 

DECtape 

(DT) 

OK 

OK 

Illegal 2 

Illegal 

OK 

Magtape 

(MT) 

OK 

OK 

Illegal 

Illegal 

OK 

DECdisk 

(DK) 

Illegal 

OK 

OK 

OK 

OK 

Disk Pack (DP) 

OK 

Illegal 2 

OK 

OK 

Illegal 

Disk Cartridge 

Illegal 

OK 

OK 

OK 

Illegal 2 


1 All DOS-15 Magtapes distributed by DEC are 800 bpi, Odd Parity. 

2 Use PIP Utility program with the (H) switch option for this operation. 












Once the last question has been answered, DOSSAV proceeds with the 
specified operation. If additional tapes are required to complete 
the restore or save operation, the tape is rewound if the unit number 
is not equal to 0 and the following message is output; 

TAPE DONE. MOUNT ANOTHER 

At this point, the user should either mount a fresh tape, if a save 
operation is being performed, or mount the next tape in the sequence 
established at tape creation, if a restore operation. Then type the 
new unit number on which the tape is mounted followed by a Carriage 
RETURN to proceed with the operation. When the requested operation 
is entirely complete, DOSSAV restarts and identifies itself as before; 

DOSSAV Vnn 
INPUT DEVICE? 

At this point the current restore or save operation is complete. If 
the DOS-15 Software was being restored, it is now ready to be started 
as specified in 7.3.2. If other DOSSAV operations are desired, the 
user should proceed again as specified in 7.3.1.1. 

7. 3.1.3 Examples of DOSSAV Commands - The following examples illustrate 
typical DOSSAV commands when restoring and saving the DOS-15 Software 
System. User responses are underlined. 


jDfsk Restoration 

11 Restore DECdisk system from DECtape unit 1; 


DOSSAV V6A 
INPUT DEVICE? DTj 
UNIT #? i ) ■ — 

OUTPUT DEVICE?DKj 

DATE CREATED; ^6"-JUN-73 

TAPE DONE. MOUNT ANOTHER 


DOSSAV V6A 
INPUT DEVICE? 


(The user mounted the next tape, 
on unit #2 then typed a 2j to 
continue.) (Operation complete 
DOSSAV restarts.) 
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2) Restore DECdisk system from Magtape unit 0: 

DOSSAV V6A 

INPUT DEVICE? mj 

UNIT #? 0J 

TRACK(7 OR 9)? 7 J 

DENSITY (2*5*8)? SJ 

PARITY (E OR 0)? 0 J 

OUTPUT DEVICE? Dk7 (All DOS-15 System Disk Restore 

DATE CREATED? 06-JUN-73 magtapes are 800 BPI, Odd Parity.) 


DOSSAV V6A (Operation complete) 

INPUT DEVICE? 

3) Restore Disk Pack System from DECtape unit 1: 

DOSSAV V6A 
INPUT DEVICE? mj 
UNIT #? \J . 

OUTPUT DEVICE? DpV ^ 

UNIT #? 0 J 

DATE CREATED j2f6-JUN-73 
TAPE DONE* MOUNT ANOTHER 
2j 

(The user mounted the next 
tape on unit number 2, then 
typed a 2) to continue.) —, 

(Operation complete.) 


4) Restore Disk Pack system from Magtape unit 1: 


DOSSAV V6A 
INPUT DEVICE? 


DOSSAV V6A 
INPUT DEVICE? MT^ 

UNIT #? 1 J 
TRACK(7 OR 9)? _ 
DENSITY (2*5,8)? 

PARITY (E OR 0)? 0, 
OUTPUT DEVICE? Dp; 

UNIT #? gj 
DATE CREATED? 06-JUN-73 



DOSSAV VGA- 
INPUT DEVICE? 


(Operation complete.) 
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5) Restore Disk Cartridge system from DECtape unit 1: 

DOSSAV V6A ' ' ! 

INPUT‘DEVICE? DTj 
UNIT #? l) 

OUTPUT DEVICE? RkP 
UNIT #? 0) 

DATE CREATED: 06-JUN-73 

TAPE DONE. MOUNT ANOTHER (The user mounted the next tape 
2J unit number 2 , then typed to 

TAPE DONE. MOUNT ANOTHER (The user mounted the next tape 

unit number 3, then typed 3 J to 
TAPE DONE. MOUNT ANOTHER (The user mounted the next tape 
2/ ■ . unit number 4, then typed 4 J to 

etc., (until all eight tapes are mounted). 

DOSSAV V6A ' 

INPUT DEVICE? (Operation complete) 

6) Restore Disk Cartridge from Magtape unit 1: 

DOSSAV V6A 
INPUT DEVICE? MT J 
UNIT #? l) 

TRACK (7 OR 9) ? ‘ ' - • ■ ' • 

DENSITY (2,5,8)? 8 J 

PARITY (E or O)?. OP 
OUTPUT DEVICE? RK 

06-JUN-73 

(Operation complete) 


Saving the Contents of the Disk 


The single example below should suffice in illustrating this type of 
operation, since save operations are simply the reverse of restore 
operations. 


Save a DECdisk system on DECtape units 1 and 2: 


(DOSSAV allows for as many 
DECtapes or Magtapes as are 
necessary to contain the en¬ 
tire contents of the speci¬ 
fied disk.) 

(Operation complete.) 


DOSSAV V6A 
INPUT DEVICE? DK*) 

OUTPUT DEVICE DTj 
UNIT#? 1 J 

TAPE DONE. MOUNT ANOTHER 

2 ) 

DOSSAV V6A 
INPUT DEVICE? 


UNIT #? 0j. 
DATE CREATED: 

DOSSAV V6A 
INPUT DEVICE? 


on 

continue) 

on 

continue) 

on 

continue) 
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7.3.1.4 Error Messages and Meanings - DOSSAV attempts to detect all 
keyboard and run-time errors and to recover if possible. The three 
types of errors which can occur are shown below along with their 
meanings and recovery procedures when applicable. 


a. Command String Errors - These errors occur when a 
question is answered incorrectly. DOSSAV repeats 
the question. 

Message Meaning 

ILLEGAL DEVICE Either an illegal device mnemonic (one 

other than DT, MT, DK, RK or DP) or an 
illegal combination of devices (DT for 
input and MT for output) was typed. 


BAD TRACK 


A track number other than 7 or 9 was 
typed. 


BAD DENSITY A density other than 2(200 BPI), 5(556 

BPI) or 8(800 BPI) was typed. 

BAD PARITY A parity other than E (even) or O (odd) 

was typed 


b. Recoverable Operating Errors - These errors occur when 
one of the I/O devices is not properly set up. When 
the condition has been corrected, operation can be re¬ 
sumed by typing the unit number of the I/O device that 
has been set up correctly, followed by a carriage RETURN 
for the first three messages. For the xx ERROR IGN 
message activate the continue switch on the console 
to continue DOSSAV; otherwise, restart DOSSAV. 

Message Meaning 


TAPE NOT READY The DECtape or Magtape unit is not switched 

to ON LINE, is not set to WRITE ENABLE, or 
is not set to the unit number specified in 
the UNIT NO? question or two or more tapes 
are on-line and dialed to the same unit number. 


DISK NOT READY. The DECdisk is not set to WRITE ENABLE. 


DISK PACK NOT 
READY 


XX ERROR IGN 


The Disk Pack unit is not switched to 
ON LINE, is not set to WRITE ENABLE or 
is not set to the unit number specified 
in the UNIT #? question. 

A parity/checksum error exists in the block 
currently being transferred; the block number 
is in the AC. 

xx = RK/DK/DP 


*1 
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c. Unrecoverable Errors - Errors associated with these messages 
are primarily hardware errors from which DOSSAV cannot re¬ 
cover. After the message is typed, DOSSAV restarts itself. 

Meaning 

Hardware error detected 

The user tried to restore 
a DECdisk system using a 
Disk Pack restore tape, 
for example. 

The user did not use a 
master restore tape (i.e., 
block 1775 is occupied) 
when restoring a system 
created for 4 or fewer 
platters to a system hav¬ 
ing 5 or more platters. 

7*3.1.5 Restart Procedures - The redstart procedures below should be 
used to terminate the current operation prematurely or to reinitialize 
DOSSAV if it fails to start up automatically after an error. 

a. Press the PDP-15 Console Switches STOP and RESET simultaneously* 

b. Set the ADDRESS switches to 34500. 

c. Press the START Console Switch. 

DOSSAV should then identify itself as when originally loaded, other¬ 
wise it must be reloaded as described in Paragraph 7.3.1.1. 

7.3.2 Loading and Starting the Monitor 

The DOS-15 Monitor is loaded into core from either the DECdisk or Disk 
Pack or Disk Cartridge 1 and is automatically started with the DOS-15 
Bootstrap Loader program. Once loaded, the bootstrap remains in the 
upper 141 g locations of the core bank into which it was loaded, dur¬ 
ing all normal system operation. The bootstrap not only aids in 
initializing the Monitor, but also acts as an integral part of the 
Monitor as it operates. It is supplied on paper tape in three ver¬ 
sions. RFBOOT is for use with a DECdisk system, REBOOT is for use with 
the Disk Cartridge systems and RPBOOT is for use with Disk Pack Sys¬ 
tems . 


1 Refer to page 7-5 for PIREX start up procedures. 


Message 

DECTAPE ERROR ^ 

MAGTAPE ERROR 
DECDISK ERROR > 

DISK PACK ERROR [ 

DISK ERROR J 

ATTEMPT TO RESTORE SYSTEM 
TO WRONG DISK 


BLK 1775 OCCUPIED. NO 
2ND SAT CREATED. 
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Each time that the DOS-15 System Software is restored using DOSSAV, 
the bootstrap must be loaded into core. Occasionally, a runaway pro¬ 
gram or hardware malfunction may cause the destruction of the Monitor 
as it resides in core, and prevent the user from restarting it by 
keyboard command. In this circumstance, it is often possible to re¬ 
start the bootstrap (unless it, too, has been destroyed) and avoid 
reloading the bootstrap. The paragraphs which follow describe the 
initial loading and restart procedures for the DOS-15 Bootstrap 
Loader. 


7.3.2.1 Loading the Bootstrap 


a. Select the appropriate version of the bootstrap (either 
DECdisk, Disk Cartridge or Disk Pack) and place it in the 
paper tape reader. 

b. Set the PDP-15 console ADDRESS switches to one of the 
addresses shown below in accordance with the maximum 
core size of the system. 


Address 


Maximum Core Size 


37637 

57637 

77637 


16K or 20K 
24K or 28K 
32K 


c. Press the console switches STOP and RESET; then press 
READIN. 


Once the bootstrap is loaded, it starts automatically and loads the 
Monitor from the disk 1 . When loading is complete, the Monitor gets 
control and identifies itself on the console teleprinter as follows: 


DOS-15 Vnn 

ENTER DATE MM/DD/YY 

The system is now loaded and operable and is ready to accept the key¬ 
board commands (Chapter 8) in accordance with the operating procedures 
described m Chapter 10. Users with new systems, that is, systems 
which have not previously been tailored, should refer to Paragraph 
7.4.2. 

7.3.2.2 Bootstrap Restart Procedures - As mentioned above, situations 
occasionally arise in which the Monitor must be reloaded by the boot¬ 
strap. If the bootstrap is intact in core, it may be restarted by 
the procedures which follow. 

: For UC15, RK based systems^, this occurs only if PIREX is running. 
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a. Set the console ADDRESS switches to one of the ad¬ 
dresses shown below in accordance with the maximum 
core size of the system. 

Address Maximum Core Size 

37646 16K or 20K 

57646 24K or 28K 

77646 32K 

b- Press the console switches STOP and RESET; then 
press START. 

c. The Monitor should then identify itself as shown 
in 7.3.2.1. 

d- If the Monitor does not identify itself, the boot¬ 
strap has been destroyed and must be reloaded as de¬ 
scribed in 7.3.2.1. 

7 • 4 SYSTEM MODIFICATION (TAILORING) PROCEDURES 

The software package supplied to each user is a general purpose ver- 
sioft °f the DOS—15 Software System. This means that the system con¬ 
tains all of the standard DOS-15 language programs, utility programs, 
library routines, and I/O device handling routines supported by 
Digital Equipment Corporation. Included as a part of this general 
package is a utility program called the System Generator (or SGEN). 
SGEN enables the user to tailor the DOS-15 software to suit the 
particular hardware configuration and operating requirements of his 
installation. 

Specifically, SGEN provides the user with the ability to: (1) delete 
system programs or add his own 1 ; (2) add and delete I/O device hand¬ 
lers; (3) add and delete system library routines; (4) alter system 
load time parameters such as: I/O device assignments, teleprinter 
model currently being used, availability of an extra memory page, 
number of buffers to be allocated, file and directory protection 
codes, etc.; (5) change system operating parameters including: the 
Priority Interrupt Skip Chain, number of positive .DAT slots, the 
presence of 7- or 9-channel Magtape drives, the Monitor Identification 
Code (MIC) and the amount of Disk Cartridge utilized for spooling on 
UC15 equipped systems. 


described in the DOS-15 System Manual (DEC-15-ODFFA-B-D) and the 
SGEN Utility Program Manual (DEC-15-USGNA-A-D). 
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CHAPTER 8 

KEYBOARD COMMANDS 

8. 1 INTRODUCTION 

This chapter describes the commands which can be issued from the con¬ 
sole keyboard to direct the operations of the DOS-15 system software. 
In communicating with the Monitor, the keyboard of the console tele- 
P-^inter is used as the system* s control device. The operator at the 
keyboard types commands to allocate system resources, load and start 
system and user-created programs, terminate program operation, and ex¬ 
change information with the Monitor. Most of the Monitor's keyboard 
commands are issued prior to loading system or user programs and are 
interpreted by the Nonresident Monitor. 

During program execution, a small set of keyboard commands is avail¬ 
able for general program control. These commands are interpreted by 
the teleprinter's I/O device handler (which is part of the Resident 
Monitor), and are used to control program start and restart, dumping 
of core, and the reloading of the Nonresident Monitor. Paragraph 8.11 
describes commands used during program execution. 

The console teleprinter is the communications interface between the 
user-operator and the Monitor. The interaction between the operator 
and the Nonresident Monitor is completely conversational. Each com¬ 
mand issued causes the Monitor to type out an appropriate reply. 
Monitor responses may vary from a single character to several pages 
of information. 

In the context of this manual, the term "console keyboard" designates 
any one of several keyboard/printer/display I/O devices which could be 
used by the Monitor as the system command console device. (That is, 
it is associated with .DAT slots -2 and -3). Generally, a Model 33 
or 35 teleprinter is used. 

The keyboard commands are, however, not strictly limited to input from 
the keyboard. The Monitor can be operated in a Command Batching Mode 
(see 8.12) in which keyboard commands can be issued from either punched 
cards or paper tape with minimum operator intervention. Similarly, 
the Monitor's responses to commands are not strictly limited to a key¬ 
board device's printer or display, but may also be output to other 
devices including the VT15 Display or a line printer, when available. 
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8.2 .KEYBOARD COMMAND FORMATS AND CHARACTERS 


8.2.1 Keyboard Command Elements 

All keyboard commands, except those using the keyboard CTRL key, consist 
of at least two elements, a command name and a terminator. Some com¬ 
mands require an additional third element consisting of one or more 
arguments inserted between the command name and the terminator. Each 
command name is separated from its argument [or argument string] by one 
or more spaces. Delimiters between multiple arguments vary, and are 
specified in the descriptions for the individual commands. Except as 
otherwise specified, each command string can be terminated by either a 
Carriage RETURN or an ALT MODE. CTRL commands are formed by simultane¬ 
ously depressing the keyboard's CTRL key and letter key, and are inter¬ 
preted by the Resident Monitor. These commands need no terminators, 
such as Carriage RETURN or ALT MODE. They are interpreted immediately 
after they have been typed. Once typed, the command is echoed in the 
form of an up-arrow (1) followed by the letter which identifies the com¬ 
mand. Thus, CTRL C is echoed tC. 

The symbols defined in the introduction to Chapter 5 are used in illus¬ 
trating the command formats described in the succeeding paragraphs of 

this chapter. DOS-15 system programs accept ASCII characters shown in 
Appendix A. 


8-2.2 Editing Features 

The teleprinter *s device handler provides two keyboard editing functions 
which can be used to change the line currently being typed (prior to 
typing Carriage RETURN or ALT MODE]. 


RUBOUT 


CTRL U 


The RUBOUT key permits successive deletion of characters 
starting with the last character., typed. Each RUBOUT 
deletes one character and causes a backslash (\] to be 
echoed in response. RUBOUT does not delete characters 
past the previous line terminator. Once all characters 
in a line have been deleted, additional RUBOUTs are 
ignored. For example, if the command INSTRUCT were mis¬ 
typed as INSTRUTC, it could be corrected by typing two 
RUBOUTs followed by CT, as shown below: 

Example: 

$INSTRUTC\\CT 


Formed by depressing the CTRL key and striking the U key, 
this command during input eliminates all characters typed 
up to the last Carriage RETURN or ALT MODE and echoes 
a ?*, Thus an irretrievably bollixed input line may be 
eliminated (before typing. Carriage RETURN or ALT MODE) 
b Y typing CTRL U. This feature can also be used during 
output to abort the current line. 
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8.2.3 When to Issue Keyboard Commands 

All keyboard commands, except for the CTRL commands (see 8.11) are 
only recognized and accepted when the Nonresident Monitor is in core, 
as evidenced by the appearance of either of the following identifiers 
on the teleprinter: 

DOS-15 Vnn where: Vnn = version number 

$ 

or 

$ 

The operator can obtain the Nonresident Monitor by typing CTRL C, (de¬ 
scribed in 8.11.1). When the Monitor is initialized using the Boot¬ 
strap, or by typing CTRL C, the full identification is typed. At all 
other times it indicates its readiness to accept keyboard commands by 
simply typing the dollar sign ($). Once the $ is typed, the Monitor 
idles until the operator types a command. 

8.3 COMMANDS TO REQUEST SYSTEM INFORMATION 

The commands in this paragraph provide the user with various lists 
of system information. The lists include: (1) general system in¬ 
formation, (2) keyboard commands/ (3) error messages, and (4) .DAT 
slot assignments. Since these lists tend to be lengthy , users who 
have either a line printer or a VT-15 Display can speed up the output 
of this information by using the special line printer and VT-15 com¬ 
mands (described in paragraphs 8.9 and 8.8, respectively). 

8.3.1 SCOM 

The SCOM command causes the typeout of DOS-15 system information. 

The information includes (1) available I/O device handlers, (2) sys¬ 
tem default parameters, (3) important core addresses, and (4) the 
Priority Interrupt Skip Chain order. 

Form: S(COM ]J 

In this and subsequent descriptions, characters enclosed in brackets 
are optional. 
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Example for non-UC15, RK based systems: 
$S 

SYSTEM INFO - DOS-15 - 11/02/71 


77646 - BOOTSTRAP RESTART ADDR 
77636 - 1ST FREE CELL BELOW BOOTSTRAP 
2722“ ADDR OF 0 DAT 
2760“ ADDR OF *UFD 


20 - NOo OF P0S @ e DAT SLOTS 
SYSTEM HAS API 
SYSTEM HAS EAE 
PAGE MODE OPERATION 

7 CHANNEL MAGTAPE ASSUMED BY HANDLERS 
80-CHARACTER LINE PRINTER ASSUMED BY HANDLERS 
2 - DEFAULT FILE PROTECTION CODE 
03 - DEFAULT BUFFS SETTING 
1274- tQ ADDRESS FOR MANUAL DUMP 
I/O HANDLERS AVAILABLE 

TTA TELETYPE* I/O, ASCII MODES , ALL FUNCTIONS 

PRA - 

PRB 
PPA 
PPB 
PPC 
DTA 
DTC 
DTD 
DTE 
DTP 
DKA 
DKB 
DKC 
DPA 
DPP 
DPC 
LPA 
CDB 
VTA 
LKA 
SKIP 


TAPE READER * INPUT, ALL MODES, ALL FUNCTIONS 
TAPE READER? INPUT, TOPS ASCII MODE, ALL FUNCTIONS 
PUNCHs OUTPUT, ALL MODES, ALL FUNCTIONS 
PUNCH: OUTPUT,ALL MODES LESS IOPS ASCII, ALL FUNCTIONS 
PUNCHs OUTPUT, IOPS BINARY MODE, ALL FUNCTIONS 
DECTAPEs 3 FILES, I/O, ALL MODES, ALL FUNCTIONS 

1 FILE, INPUT, IOPS MODES, LIM FUNCTIONS 
S FILE, I/O, ALL MODES, ALL FUNCTIONS 
1 FILE, I/O, ALL MODES, NO „MTAPE 
NON-FILE ORIENTED FOR F4 a OTS 
N FILES, I/O, ALL MODES, ALL FUNCTIONS 
N FILES, I/O, ALL MODES, LIM FUNCTIONS 
N FILES, INPUT, ALL MODES, LIM FUNCTIONS 
N FILES, I/O, ALL MODES, ALL FUNCTIONS 
N FILES, I/O, ALL MODES, LIM FUNCTIONS 
N FILES, INPUT, ALL MODES, LIM FUNCTIONS 
PRINTER: OUTPUT, ASCII MODES, ALL FUNCTIONS 
READER: INPUT, IOPS ASCII MODE, ALL FUNCTIONS 


DECTAPE? 
DECTAPE: 
DECTAPEs 
DECTAPE: 
DECDISKs 
DECDISK: 
DECDISKs 
DISKPACKs 
DISKPACK: 
DISKPACKs 
LINE 
CARD 
VT-15: I/O 
LK-35 KEYBOARD: 
CHAIN ORDER 
SPFAL 
DTDF 
DSSF 


INPUT, ASCII MODES, ALL FUNCTIONS 


DPSJ 

SPDI 

WTSK 

PCSF 

RCSD 

CLSF 

LSDF 

RSF 

PSF 

KSF 

SPKF 

TSF 

DTEF 

DPSE 

MPSNE 

MPSK 

SPE 



“A 
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Example for UC-15 systems: 

SYSTEM INFO * 003-15 * 88/12/74 







77646 . BOOTSTRAP RESTART AQDR 


77636 - 1ST FREE CELL 8EU0W BOOTSTRAP 

4063® ADOR OF 9 OAT 

4181* ADDR OF „UFO 

20 • NO. OF P03„ 9 DAT SLOTS 

SYSTEM Has EAE 

BANK MODE OPERATION 

7 CHANNEL MaGTaPE ASSUMED 8Y HANDLERS 


2 - DEFAULT file protection code 

03 - DEFAULT BUFFS SETTING 

140g ®» a 0 ADDRESS FOR manual dump 
I/O HANDLERS available 

TT A TELETYPE? I/O, ASCII MODES, ALL FUNCTIONS 

PRA tape READER? INPUT > ALL MODES, ALL FUNCTIONS 

PRB TAPE READER? INPUT# IQP$ ASCII MODE, ALL FUNCTIONS 

PPA PUNCH? OUTPUT# ALL MODES # ALL FUNCTIONS 

PPB PUNCH 8 OUTPUT,ALL MODES LESS IQP$ ASCII? ALL FUNCTIONS 

PPC PUNCH! OUTPUT, IOPS BINARY MODE, ALL FUNCTIONS 

DTA DECT APE 8 S FILES, I/O, ALL MODES, ALL FUNCTIONS 


DjC 
DTD 
DTE 
DTP 
DK A 
RKB 


MTA 

mtc 


oectarEi 

DECTAPE? 
RECtAPE 8 
0ECTAPE8 
DECDISK? 
DECDISK 8 


1 FILE? 

1 FILE, 

i file# 

NQNraFILE 
N FILES, 
N FILES, 


magtape? 

magtape? 

magtape? 


INPUT, IOPS MODES# LIM FUNCTIONS 
I/O, ALL MODES, ALL FUNCTIONS 

I/O, all modes, NO 0 mtape 
ORIENTED FOR F4 a 0T8 
1/0# ALL MOOES# ALL FUNCTIONS 
I/O# ALL MODES, LIM FUNCTIONS 

ALL MODES, LIM FUNCTIONS 
ALL MODES, ALL FUNCTIONS 
ALL MOOES# LXM FUNCTIONS 
, ALL MOOES# LIM FUNCTIONS 
ALL MOOES, ALL FUNCTIONS 


3 FILES# I/O# ALL MODES# ALL FUNCTIONS 
1 FILE? INPUT# IOPS MODES# ALL FUNCTIONS 
N0N«»F ILE ORIENTED FOR F4 a 0?S 


DKC 

DECDISK1 

N 

FILES, 

INPUT, 

DP A 

diskpack % 

N 

FILES# 

I/O, 

D Pg 

DISKPACK 8 

N 

files# 

I/O, 

DPC 

diskpack 8 

N 

files# 

INPUT 

RK A 

QISKCARTS 

N 

FILES# 

I/O, 

RK0 

DISKCARTf 

N 

FILES# 

I/O, 

RKC 

DISKCART? 

N 

FILES# 

INPUT 


LPA LINE PRINTERS OUTPUT# ASCII MODES, ALL FUNCTIONS 


COB CARD READER? INPUT# IOPS ASCII MODE, ALL FUNCTIONS 
VPA VP DISPLAYS OUTPUT# ASCII AND DUMP MODES# ALL FUNCTIONS 
VTA. VT»1S8 I/O 

XYA PLOTTER I OUTPUT# ASCII & BINARY MODES# ALL FUNCTIONS 
LKA LK-3S KEYBOARDS INPUT# ASCII MODES# ALL FUNCTIONS 
SKIP CHAIN ORDER 
SPFAL 


QTOF 
DSSF 
RKSF 
DP S J 
MTSF 
SPDI 
WTSK 

sddf 

rcsf 

RCSD 

LSDF 

CLsSF 

rsf 

PSF 

KSF 
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TSF 

DTEF 

DPSE 

MPSwE 

Mp$« 

9PE 
COSF 
LPSF 
PL 8 F 











8.3.2 INSTRUCT , , ' _ _ , ' 

The INSTRUCT command causes a typeout of either the keyboard commands 
or system errors, depending upon which form of the command is used. 
This command utilizes .DAT-12 as the output device. 

Form 1: I[NSTRUCT] J 

Example for non-UC15, RK based systems: 

$1 


DOS-15 COMMANDS® 

LOG(L): USED COMMENTS TERMINATED BY ALTMODE 

TERMIHATED PY ALTMODE, WAIT FOR tP TO CONTINUE 

uf\ I t CD; « ECHO DATE 

DATE CD) MM/DD/YY? ENTER DATE 

TIME(T): ECHO TIME 

TIMECT) HHMM? ENTER TIME 

PROTECT CP) NS CHANGE DEFAULT PROTECTION CODE TO N 

KEEPCK) ON/OFFs KEEP .DAT SLOTS UNALTERED ON .EXIT 

LOGIN UIC® DEFINE NEW CURRENT UIC 

LOGOUTs SIGN OFF UIC 

BOSS 15s ENTER BOSS 15 BATCH MODE 

SCOMCS)® SYSTEM INFO 

I NSTRUCT CDs LIST OF MONITOR COMMANDS 

INSTRUCTED ERRORS? DESCRIPTION OF ERROR CODES 

bronffnS>’,£^ UESTCR) PRGNAM? *DAT SLOT USAGE 
REQUEST CR) USER? POSITIVE .DAT SLOT USAGE 

ASSTGNCA) DEVN <UIC> A,B,.•./ETC.: .DAT SLOT MODS 
QDUMPCQ): SET TO SAVE CORE CtQ) ON .IOPS ERROR 
HALTCH)? SET TO HALT ON .IOPS ERROR 
TQM? SAVE CORE ON UNIT N 
GETCG) ® RESTORE CORE FROM TQ AREA 

RESTORE CORE FROM TQ AREA AND RESTART WITH TP 

RES‘1 ORE CORE FROM fQ AREA AND RESTART WITH ?T 

RESTORE CORE FROM TQ AREA AND RESTART WITH TS 

N FILE ® RESTORE CORE FROM FILE ON UNIT N Awn rfqtapt 
GETP N FILE . RESTORE CORE FROM FILE (UNIT N) AND RESTART H?TH tP 

GFTT N FILE • RESTORE CORE FROM FILE ON UNIT N AND RFST4RT ut?u !t 

R pnI 0P ? ??2 E FR0M FlLE 0N UNIT N AND RESTART WITH TS 

ADT PUT AREA INTO FILENM ON UNIT N 

API ON/OFFs CHANGE STATE OF API 

VT ON/OFF? TURN GRAPHIC DISPLAY ON/OFF 

^ l l 0N/0FF? TUR N HALF BUFFER MODE FOR GRAPHIC DISPLAY ON/OFF 
33TTY ON/OFF® CHANGE STATE OF TELETYPE 

LP ON/OFFs TURN ON/OFF LINE PRINTER FOR OUTPUT OF SOME NPM COMMANDS 
X4K ON/OFFs CHANGE STATE OF EXTRA 4K CORE CONFIGURATIONS 
BANK ON/OFF® CHANGE STATUS OF BANK MODE ATIONS 

PAGE ON/OFFs CHANGE STATUS OF PAGE MODE 
BUFFS N? CHANGE DEFAULT BUFFER ALLOCATION 

C r^prc T npr S nnFVc DEFAULT ASSUMPTION FOR MAGTAPE 
tC; RESTORE DOS-15 tP? USER RESTART 
tXs TURN VT ON OR OFF 


GETP 
GETT s 
GETS j 
GETCG) 


tTs RESTART DDT 
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•DOS-15 PROG LOADING COMMANDS AND PROGNAM FOR REQUEST COMMAND 
LOAD? LINK LOAD AND WAIT FOR tS 
GLOADt LINK LOAD AND GO 

DDT? LINK LOAD WITH SYMBOLS AND GO TO DDT 
DDTNSf LINK LOAD W/O SYMBOLS AND GO TO DDT 
MACRO? SYMBOLIC MACRO ASSEMBLER 
F4? FORTRAN IV COMPILER 
EDIT® TEXT EDITOR 
PIP?°PERIPHERAL INTERCHANGE PROG 
SGEN? SYSTEM GENERATOR 
DUMP? BULK STOR DEV DUMP 
UPDATE? LIBR FILE UPDATE 
SPCCOM? SOURCE COMPARE 
EDITVP? STORAGE SCOPE EDITOR 
EDITVT? GRAPHIC DISPLAY (VT) EDITOR 
PATCH? SYSTEM TAPE PATCH ROUTINE 
EXECUTE(E) FILE? LOAD AND RUN FILE XCT 
CHAIN? XCT CHAIN BUILDER 
8TRAN? PDP-8 TO PDP-15 TRANSLATOR 
89TRAN? PDP-8 TO PDP-9 TRANSLATOR 
MTDUMP? MAG-TAPE UTILITY PROGRAM 
DTCOPY? DECTAPE COPY PROGRAM 
DOS-15® BATCH 

BATCHCB) DV? ENTER BATCH MODE WITH DV AS BATCH DEV 
DV? PR = PAPER TAPE READER 
CD = CARD READER 

$JOB? CONTROL COMMAND WHICH SEPARATES JOBS 

$DATA? BEGINNING OF DATA 

SEND? END OF DATA 

$PAUSE? WAIT FOR tP ON TTY 

$EXIT? LEAVE BATCH MODE 

tT; SKIP TO NEXT JOB 

fC? LEAVE BATCH MODE 

tR? CONTINUE FROM $PAUSE 


Example for RK based UC15 systems: 

D0S®»1 5 COMMANDS? 

LOGeU? USER COMMENTS TERMINATED BY ALTMODE 

LQGWl USER COMMENTS TERMINATED BY AlTMODE* WAIT FOR aP TO CONTINUE 

OATECD5i ECHO DATE 

DATE C D 5 MM/DD/YYI ENTER DATE 

TIME mg ECHO TIME , 

timecto mhmni enter time 

PROTECT CP3 N1 CHANGE DEFAULT PROTECTION CODE TO N 

Keepcm on/off? keep b pat slots unaltered on b exit 

LOGIN UICI DEFINE NEW CURRENT UIC 

LOGOUT? SIGN OFF UIC 

BOSS1Si ENTER BQSSI5 BATCH MODE 

SCOMfS5§ SYSTEM INFO 

INSTRUCTCI)* LIST OF MONITOR COMMANDS 

instructcd errors? description qf error COOES 

REQUEST(R), REQUESTCR3 PRQNAMl B 0AT SLOT USAGE 

REQUEST CR) USER? POSITIVE 0 D AT SLOT USAGE 

ASSIONfAl SEVN ^UIC& A p B ?9ae ^ETC e l a DAT SLOT MODS 

QDUMPC05I SET TQ SAVE CORE CaQ] ON a IQPB ERROR 

HALTIN')i SET TO HALT ON e IOP$ ERROR 

aQNi SAVE CORE ON UNIT N 

SET(851 RESTORE CORE FROM aQ AREA 

GETPlCORE FROM aQ AREA AND RESTART WITH aP 

SETT 1 RESTORE CORE FROM &Q AREA AND RESTART WITH at 

GETS l RESTORE CORE FROM aQ AREA AND RESTART WITH as 

GETCG5 N FILE ? RESTORE CORE FROM FILE ON UNIT N AND RESTART 

GETP N FILE 1 RESTORE CORE FROM FILE ON UNIT N AND RFSTART WITH aP 

SETT N FILE 1 RESTORE CORE FROM FILE ON UNIT N ANO RESTART WITH aT 




GETS N FILE I RESTORE CORE FROM FILE QN UNIT N AND RESTART WITH a§ 

PUT N FILEnm I RUT aQ AREA INTO PILENM ON UNIT N 

API On/OFF ® CHANGE STATE OF API 
VT ON/OFFS TURN GRAPHIC DISPLAY ON/OFF 

HALF ON/OFF? TURN half BUFFER MODE FOR GRAPHIC DISPLAY ON 
33TTY/LA30 pN/OFFI CHANGE STATE OF TELETYPE 

LP ON/OFF* TURN ON/OFF LINE PRINTER FOR OUTPUT OF SOME NRM COMMANDS 

Y4K ON/OFFS CHANGE STATE OF EXTRA 4K CORE CONFIGURATIONS 

BANK ON/OFF1 CHANGE STATUS OF BANK MODE 

PAGE ON/OFF? CHANGE STATUS OF PAGE MOPE 

RUFFS N j CHANGE DEFAULT BUFFER ALLOCATION 

CHANNEL 7/Pf SETUP DEFAULT ASSUMPTION FOR MAGTAPE 

F fl LPA/CDA/^VAl FLUSH ALL SPOOLED DATA 

F,LP§/CDS/XY$8 FLUSH LAST SPOOLED DATA 

ac? restore oos®is api user restart ati restart dot 

aX? turn vt on or off 

d0$®15 prog loading COMMANDS and prqgnam for REQUEST command 
loads link load AND wait FOR a$ GLOADlf 
GLO^Oe link CQAO and go 

DDT? LINK load with SYMBOLS AND GO TO DDT 
DDTNSi LINK LOAD W/Q SYMBOLS AND GO TO DDT 

macro? mac*o»13 assembler 

pAi FORTRAN XV COMPILER 
EDIt§ text editor 

PIP e PERIPHERAL INTERCHANGE PROG 
DUMP? bulk STOR dev dump 
UPDATES LISP FILS UPDATE 
srccoms SOURCE compare 
EDITVPs STORAGE SCOPE EDITOR 
FDITVT? GRAPHIC DISPLAY IVT5 EDITOR 

patch? system tape patch routine 

EXECUTeee) FILES LOAD ANO RUN FILE *CT 
CHAIM? «CT CHAIN BUILDER 
FTP AN « PDP-B TO POP® i 5 TRANSLATOR 
B9TRAN ® PDP«^R TO PDP-9 TRANSLATOR 
MTDUMP8 mAg^TAPE UTILITY PROGRAM 
DTCOPy ? OECTAPE COPY PROGRAM 
MAC 1 I? SYMBOLIC MACRO^l 1 ASSEMBLER 
SPOOL g INPUT/OUTPUT SPOOLER CONTROL PROGRAM 
DOS®1S 8 BATCH 

BATCH f B5 DV? ENTER BATCH MODE WITH DV AS BATCH DEV 
13V® PR ® PAPER TAPE READER 
CD a CARD READER 

$JOB S CONTROL COMMAND WHICH SEPARATES JOBS 

$DAT A 8 BEGINNING OF DATA 

'SEND® END OF DATA 

SP A USES WAIT FOR aR ON TTY 

15EX1Y? lEAVF BATCH MODE 

at? SKIP to next job 

*CS LEAVE BATCH MODE 

aR 8 CONTINUE FROM SPAUSE 
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Form 2: I [NSTRUCT]^ ERROR[S ]J 



Example: 


$1 ERRORS 


DOS®15 - s I0P§g 

0 ILL FUNCTION CAU » GAL ADDR 

1 CAL# ILL • CAL ADDR 

2 oDA? SLOT ERROR • CAL AOBR 

3 ILL INTERRUPT * I/O STATUS RiSliTlR 

4 DEV NOT REARV • TYRE aR WHIN RBADV * 

5 ILL •SETUP CAL * GAL ADDR 

6 ILL HANDLER FUNCTION « GAL A0OR * 

7 Hi DATA MODE • CAL-ADDR * 

10 FILE STILL ACTIVE ■ CAL ADDR ** 

11 SgEK/gNTER NOT EXECUTED * CAL ABOR * > - 

12 unrecoverable device error * status res b and unit no s 

13 FILE NOT FOUND - 6AL ADDR ** 

14 DIRECTORY FULL ■ GAL ADDR 

15 DEVICE FULL - CAL ADDR ** 

16 OUTPUT BUFFER OVERFLOW • GAL ADDR 

17 Toe MANY FILES FOR HANDLER « SAL AQdR * 

20 DISK FAILURE ?Q RETRY3 « DISK STATUS g BLK * P DEVXCE/UNIT # P CAL FUNCjtllC 

21 ILL DISK ADBR • BLOCK NQ^DEV|GI/UN|T NOpCAL FUNGTIONpUIC 

22 TWO OUTPUT FILES ON ONE DECYAPE UNIT « GAL ADDR 

23 ILL WORD PA SR COUNT « CAL ADDR ** 

25 NMAffVF OR 0 CHARACTER COUNT £l0Pg ASCII WRITER 
X OR ¥ INCREMENT TOO LARES (*2**14) ^BINARY WRITES 
27 ILLEGAL WRITE TYPE 

30 API SOFTWARE LEVEL ERROR • API STATUS RES 

31 NONEXISTENT MEMORY RKF • PC ! 

32 MEMORY PROTECT VIOLATION » PC 

33 MEMORY PARITY ERROR ■ PC 

34 POWER FAIL SKIP NOT SETUP ® PC 

37 line ovfto ® cal addr 

40 HEADER LABEL ERROR • CAL ADDR 

41 DIRECTORY format ERROR • CAL ADDR 

42 ACCESSIBILITY MAP QVFLO • CAL ADDR 

43 DIRECTORY RECORDING ERROR • CAL ADDR 

44 LOGICAL EOT FOUND « CAL ADDR 

.48 LON@ INPUT RECORD « CAL ADDR ■ ^ 

46 ATTEMPT TO DELETE SYSTEM Fill • CAL ADDR 

47 ILL HORIZONTAL TAB ® CAL ADDR 

Si ILLEGAL USER Fill DIRECTORY - SAL ADDR 
33 NO BUFFERS AVAILABLE • CAL ADDR * 

0i parity error in directory or file sit map « cal addr * 

03 PROTgcTFO USER FILE DIRECTORY • CAL ADDR * * 

@4 Protected file • cal addr 

65 UNRECOVERABLE MAGTAPE ERROR « MT STATUS 

eg relative block is 0 or not within file scope c s rtran^ 

B7 «RTRAN ARGUMENTS CAUSE DATA SLOCK OVERFLOW • CAL ADDR ## 

70 buffer si?e too small « cal addr * 

71 EMPTY Ufc 

7 2 INPUT PARITY OR WRITE CHECK ERROR £aR TO RETRY5 

- CALADDRpBLOCK NO r DEVICE/UNIT NQ.eAL FUNCTIONpUIC 
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73 null file name given on seek/en?er/dl£te/fsta?/rand * 

74 PILE STRUCTURE DEGRADATION « ATTEMPT TO CLEAR 8UBMAP 

Bf? that was already off 

75 FILE STRUCTURE DEGRADATION * ILLEGAL SUBMAP WORD! 

76 FILE STRUCTURE DEGRADATION * ILLEGAL BACKWARD POINTER FOR FIRST 

MFD OR MFD BLOCK OR TO RETRY) 

77 ATTEMPTED USE OF NON«£XISTANY aQ AREA 

* DISK ONLY? 

CAL ADDRgDEVICE AND UNI? NO« gCAL FUNCTION fl UlC 
** DISK ONLY I 


CAL ADDRfDEVICE AND UNIT N0 a j CAL FUNCTION,UIC,FILE NAME 
LOADER ERRORS - s LO AD OR B SYSLD 

1 MEMORY OVERFLOW 

2 DATA ERROR 

3 SlJBR NOT FOUND 

4 @DAT SLOT ASSIGNMENT ERROR 

5 PROG SEGMENT GREATER THAN 4K CPAGE MODE) 
object TIME SYSTEM ERRORS » @OTS 

6 ILL REAL SQUARE ROOT ARG 

b ill double square root arg 

7 ILL INDEX IN COMPUTED GOTO 

10 ILL I/O DEV H 

11 ILL INPUT DATA 

12 ill format statement 

13 ILL real LOG ARG 

14 ill double log arg 

is zero raised to zero or negative power 

16 A?AN2C0.@»@U) 

17 DATAN2 C® a li@ p @ *000) 

21 UNDEFINED FILE 

22 ILLEGAL RECORD SIZE 

23 SIZE DISCREPANCY 

24 TOO MANY RECORDS OR ILLEGAL RECORD $ 

25 mode discrepancy 

26 Too many open files 

3® single integer overflow 

31 extended eoouBLE) integer overflow 

32 single flt s overflow 

33 DquBlE FLT a OVERFLOW 

34 single fl? s underflow 

35 Double fly* underflow 

36 FLT‘ a DIVIDE CHECK 

37 Integer divide check 

4® ILLEGAL CHARACTER COUNT 

41 Array EXCEEDED 

42 BAD INPUT DATA 

3® FPP MEMORY PROTECT/NON-EXISTANT MEMORY VIOLATION 
Si ILLEGAL I/O DIRECTION CHANGE TO DISK 



UC15 SYSTEM ERROR MESSAGES 

The error messages from tasks running under PIREX have the following 
format; 

IOPSUC YYY XXXX 

Where YYY denotes one of the followings 

EST Stop all I/O task 

ESD Software Driver " 

RKU Disk Cartridge " 

DTU DECtape 

LPU Line Printer " 

CDU Card Reader " 

PLU Plotter " 

ESP Spooler " 

EMA MACH " 

XXXX denotes one of the following; 

3 - Illegal interrupt to driver 

4 “ Device not ready 

12 - Device failure 

15 - Spooler full---warning message 

45 - Greater than 80 columns in card 

55 - No spooler buffers available 

72 - Illegal punch combinations 

74 - Timing error—card column lost—retry card 

75 - Hardware busy*—driver not 

76 - Hardware error between cards 

77 - Unrecognized task request-device not present 
400 ~ Spooler empty*—PDP-15. Input request pending 

Additional IOPS error messages; 

These error message are not listed by the INSTRUCT command. 
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Error Code 


200 

300 

400 

500 

600 

777 


8.3.3 REQUEST 


Nonexistent task referenced,. 

Illegal API level given (illegal values 
are changed to level 3 and processed). 

Illegal directive code given. 

No free core in the PDP-11 local memory. 

ALT node for this TCN missing. 

Request node was riot available from the 
POOL r i.e., the POOL was empty and the 
referenced task was currently busy or the 
task did not have an ATL node in the 
Active Task List. 


The REQUEST command causes a typeout of the I/O Device Handlers 
currently associated with the slots of the Monitor's Device Assignment 
Table (.DAT). Since this command is closely related to the commands 
which affect I/O device assignments, it is described in paragraph 
8.5.1. 


8.4 COMMANDS RELATED TO FILE PROTECTION 


8.4.1 LOGIN 


This command permits the operator to enter his User Identification 
Code (UIC) into the system in order to do directoried disk I/O. 

After a LOGIN, the Nonresident Monitor sets the slots of the User 
File Directory Table (UFDT) to the three-character code entered. 

All input/output operations to the disk are directed to the UFD 
associated with the last UIC entered by this command, unless a program 
has subsequently executed a .USER I/O Macro, or the operator has 
issued an ASSIGN command (see 8.5.2). 
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Each LOGIN command issued enters a new UIC into the system and auto— 
matically deletes the one entered previously. Each LOGIN is an im¬ 
plicit LOGOUT (see LOGOUT, in paragraph 8.4.4). A UIC must consist 
of exactly three alphanumeric characters in any combination except 
"@@@", "???", "PAG", "BNK", "SYS", "IOS" and "CTP". 

Form: LOGIN^uicJ 

where: uic = User Identification Code 

8.4.2 MICLOG 

This command permits the Monitor Identification Code (MIC) to be 
entered into the system. This provides the operator with unrestricted 
access to all files contained in the various directories on the disk 
and permits the system programs SGEN and PATCH to be used to modify 
the system. The MIC of each system, as initially supplied to the user, 
is "SYS". As with LOGIN, a MICLOG entry is deleted from the system 
by the LOGOUT or LOGIN commands. The MIC is usually known only by 
the system owner, and the code is easily changed at system generation. 

Form: MICLOGa.»micJ 

where: mic = Monitor Identification Code 

8.4.3 PROTECT 

The PROTECT command is used to alter the default value of the file 
protection code, set when the system was generated (by the SGEN 
program). The default file protection codes set by this command 
remain in effect until another PROTECT command is given or until the 
user issues a LOGIN or LOGOUT (which resets the protection code to 
the system’s default value). Refer to 4.7.3 for a list of these codes. 

Form: P [ROT'ECT]^n j 

where: n = Protection Code 

8.4.4 LOGOUT 

This command deletes the current UIC or MIC entry from the system. 

LOGOUT also resets all system parameters affected by keyboard commands 
to their default status. These parameters include: 
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a. -DAT and .UFDT assignments. (ASSIGN command) 

b. Commands which, take an "ON/OFF" argument, such as: 

KEEP, X4K, 33TTY, LA30, HALF, LP, PAGE/BANK, API, and VT. 

c. Commands which take a numeric argument, including: 
CHANNEL, PROTECT, and BUFFS. 


Form: LOGOUT \ 

8.5 COMMANDS DEALING WITH I/O DEVICE ASSIGNMENTS 
8.5.1. REQUEST 

This command causes a typeout of the I/O devices currently associated 
with the slots of the Monitor's Device Assignment Table (.DAT) and 
the UIC's associated with the User File Directory Table (.UFDT). The 
command can be issued using various arguments which result in a Complete 
printout of the assignments or selected portions thereof. If REQUEST 
is issued with no argument, the entire .DAT/.UFDT list of assign¬ 
ments is output. If the argument USER is inserted, only the positive 
(user) .DAT and associated .UFDT assignments are output. If an argu- 
ment which is a legal system program name is used (e.g. , MACRO, PIP, 
etc.), only the assignments for that program are output. 

, Form: R [EQUESTJ^j^®^. 

"prog" may be any of the following: 


MACRO 

EDIT 

F4 

EDITVP 

FOCAL 

EDITVT 

PATCH 

SGEN 

DTCOPY 

SRCCOM 

GLOAD 

CHAIN 

LOAD 

EXECUTE 

DUMP 

8 TRAN 

MTDUMP 

89-TRAN 

UPDATE 

dDt 

PIP 

DDTNS 

MAC 11 


SPOOL 



Examples: 


*DAT DEVICE U1C 
-15 DKA SCR 
-14 DKA SCR 
-13 DKA SCR 
-12 LPA SCR 


* Unichannel-15 systems only. 

Only for RK based UC15 systems. 
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-11 

DKA 

SCR 

-10 

TTA 

SCR 

-7 

DKL 

SYS 


DKA 

SCR 

so 5 

NON 

SCR 

— A 

DKA 

SCR 

-3 

TTA 

SCR 

-2 

TTA 

SCR 

-1 

DKA 

SYS 

3-1 

DKA 

SCR 

3-2 

DKA 

SCR 

4-3 

DKA 

SCR 

4-4 

TTA 

SCR 

4-5 

PRA 

SCR 

4*6 

PPA 

SCR 

4-7 

DTA1 

SCR 

4- S 0 

VTA 

SCR 

4-1 1 

NON 

SCR 

4-12 

DTA2 

SCR 

4-13 

NON 

SCR 

4-14 

NON 

SCR 

4-15 

NON 

SCR 

4* 1 6 

NON 

SCR 

4-17 

NON 

SCR 

4-20 

NON 

SCR 


Example 2: 


$R USER 


0 dat 

DEVICE 

UIC 

4-1 

DKA 

SCR 

4*2 

DKA 

SCR 

4-3 

DKA 

SCR 

4*4 

TTA 

SCR 

4-5 

PRA 

SCR 

4-6 

PPA 

SCR 

4-7 

DTA 1 

SCR 

4- S 0 

VTA 

SCR 

4-11 

NON 

SCR 

4-12 

DTA2 

SCR 

4-13 

NON 

SCR 

4-14 

NON 

SCR 

4-15 

NON 

SCR 

4-16 

NON 

SCR 

4-17 

NON 

SCR 

4-20 

NON 

SCR 


Example 3: 


$R MACRO 


e DAT 

DEVICE 

UIC 

USE 

-14 

DKA 

SCR 

INPUT 

-13 

DKA 

SCR 

OUTPUT 

-12 

LPA 

SCR 

LISTING 

— 1 1 

DKA 

SCR 

INPUT 

-10 

TTA 

SCR 

SECONDARY 
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8.5.2 ASSIGN 


This command permits the temporary reassignment of the various slots 
of the Monitor's Device Assignment Table (.DAT) to I/O device handlers 
other than those permanently assigned at system generation. In addi¬ 
tion, the corresponding slots of the User File Directory Table (.UFDT) 
can also be reassigned to UIC's other than the UIC which is currently 
i'n effect. Unless the KEEP command is issued, the change of assign¬ 
ment is effective only fo r the current job (i.e., the program about to 
be run), since the permanent assignments are restored when the Nonresi¬ 
dent Monitor regains control (i.e., after the current job has terminated) 
The KEEP command (described below) can be used to retain assignments 
from job to job. 


Prior to using ASSIGN, the user should be familiar with the various 
handlers which can be used with the program for which the assignments 
are to be made. Chapter 9 describes the handlers in the system. A 
list of the handlers available on any given system can be obtained in 
the printout obtained with the SCOM command. The following rules should 
be observed when typing ASSIGN commands: 


:: •. .. ■ V...V : • • .. :■ . . |j 

a. Device handler names consist of three characters which 
can be abbreviated to two characters if the last char¬ 
acter is an "A". Thus, "DKA" becomes "DK" . In addi¬ 
tion, a number can be typed as a fourth character to 
specify the device unit number (in octal),, The unit 
number is applicable for devices which can have more 
than one unit: Disk Pack, Disk Cartridge, DECtape, 
and Magtape. If the unit number is zero, it need not 
be specified* Thus, "DTA0" becomes simply "DT", sim¬ 
ilarly, "DPBJZf" can be typed as "DPB". "DTA1" may be 
typed as "DTI". 

b. .DAT/.UFDT slot numbers (octal) must be within the legal 
range for the particular system being used. Since the 
number of negative slots does not change (-15 is the 
lowest negative slot), the user need only be concerned 

the number of positive slots available. This can 
be determined either from a SCOM or a REQUEST USER com¬ 
mand . 

c. A series of assignments can be typed on the same line, 
using a single ASSIGN command, by separating the as¬ 
signments with a slash (/). The user can then type 
another device name, UIC, and slot number (s). (See 
examples below.) 

d. Assigning NON instead of a device handler name will 
assign a null handler to .DAT slots that are not 
needed. This will save core since no handler will 
be loaded at run time. 



Form: A[SSIGN] 


a{,b,c,etc.3 j 



where: 

uic = legal User Identification Code 
dev = Device Handler name and unit (if applicable) 
a,b,c,etc, = Legal slot numbers 
NON = No device handler 
Examples: 


1= To assign the teleprinter to .DAT slot -11 and the 
paper tape reader (version A) to .DAT slot 14, type: 

AuTTu'-llJ 

J 

or 

; Afe.jTT / PRul4P 

2. To assign UPD "ABC" to .UFDT slot -14, and the Disk Pack and 
UFD "TRE" to .UFDT slot 10, type: 

A a _ s < ABC>e ras j —14 / DP^ TRE^ljZf J 

3. To assign the Disk Pack to several .DAT slots, type: 

AoDftj 1,2,3,15^ 

8.5.3 KEEP ON/OFF 

This command instructs the Monitor either to retain or reset .DAT/.UFDT 
slot assignments after the current program (for which the assignments 
were made) terminates execution and control returns to the Monitor. 

"ON" retains assignments and "OFF" allows them to be reset. When a 
LOGOUT command is issued, the "OFF" parameter is automatically set. 

Form: K[EEP]^{°“ p }J 

8 “ 6 CORE ALLOCATION COMMANDS 
8.6.1 BUFFS 


This command temporarily changes the parameter which specifies the 
default value for the number of buffers available in the Monitor's 
buffer pool for disk I/O and for the .GVBUF and .GTBUF Monitor Com¬ 
mands. The default value is restored whenever the Nonresident Monitor 
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returns. This value is set during system generation along with the 
actual size of the buffers to be allocated (the default values for 
systems as initially distributed are: Number of Buffers = 3, Buffer 
Size = 5 00 Q \. , ’ 


The user should exercise care when issuing this command, since the 
Disk device handlers and the DECtape "A" handler obtain the buffers 
is required for each opened file. Terminal errors result when an 
insufficient number of buffers is available. Alternatively, program 
loading errors occur when the number of buffers allocated results 
in an insufficient amount of core for program loading. When request¬ 
ing system programs, the user need not be concerned about buffer 
availability since each system program has its own default param¬ 
eter for the maximum number of buffers required (e.g., MACRO has 3, 

EDIT has 2.). 

Form: BUFFS^n^ 

where; n = number of buffers (decimal radix) desired. 

8.6.2 X4K ON/OFF 

This command informs the Monitor of the availability of a page (4K) 
of memory in systems which have an odd number of memory pages (i.e., 

2OK and 28K systems). The additional core space, when specified as 
available, is used for loading system and user programs. 

Form: X[4KW°^ } J 

8 * 7 CORE IMAGE SAVE/RESTORE COMMANDS 

The commands described in this section provide facilities for saving 
and restoring the entire image of core. These commands can be used to 
advantage not only for obtaining "snapshots" of core for debugging 
purposes, but also for rapid loading of commonly used programs, parti¬ 
cularly user-created programs which use many library routines 

These commands work in conjunction with a reserved area on the DECdisk 
and each Disk Pack or cartridge called the Save Area, or QAREA. The 
QAREA is a temporary storage area into which a core image may be dumped . 
and from which core images are restored. This is considered a temporary 
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storage area since each time a command to dump core is given, the 
previous contents of this area are lost,, Additional commands are 
therefore supplied, to permit users to create named files of core 
images in the QAREA. Such files can be used for permanent storage 
and can be restored to core via Keyboard commands. The DUMP 
program can be used to obtain listings of core dumped into the QAREA. 

8.7.1. CTRL Q 

This command interrupts the program currently running, dumps the en¬ 
tire contents of core into the QAREA of the system device and returns 
control to the Nonresident Monitor. Users with Disk Packs or Cartrid' 
ges must specify on which unit the dump is to take place. The 
command is typed by simultaneously depressing the CTRL and Q keys 
on the keyboard. Upon receipt of the command, the Monitor echoes a 
+Q * (If no echo occurs, no QAREA exists on the device, or the system 
has crashed.) If the system device is Disk Pack or Cartridge, the 
Monitor waits for the user to type a unit number before processing," 
otherwise processing continues automatically, core is dumped into the 
QAREA and the Monitor regains control as shown below. 

Form: CTRL Q 

Response: tQn 

DOS-15 Vnn 

$ 


where: n - Disk Pack or Cartridge Unit Number ( 0 - 7 ) 

8 • 7 * 2 QDUMP 

a CTRL Q 
IOPS 

Form: Q[DUMP ]) 

8.7.3 PUT 


This command instructs the Monitor to automatically execute 
command (see above) when a terminal IOPS error is detected, 
errors are listed in Appendix D. 


This command instructs the Nonresident Monitor to create a file, 
which is a copy of the current contents of the specified QAREA, on 
the device associated with * DAT slot -14. If the system device is 
Disk Pack or Disk Cartridge, a unit number can be specified; other¬ 
wise 0 is assumed. The user must type a file name which may consist 
of up to six characters and a three character extension. 
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Form: PUT^nj^filnam^extj 

where: 

n = Disk Pack or Disk Cartridge Unit Number (0-7); 0 assumed 
if not specified 

filnam = File Name (1-6 characters) 

ext = Required filename extension (1-3 characters) 

8.7.4 GET 

This command instructs the Monitor to restore (to core) a core image 
residing either in the QAREA of the system device, or on the device 
associated with .DAT slot —14 as a named file (i.e., created by a PUT 
command). No name with the command gives the first option. If the 
user supplies a name, the second option (.DAT -14) will be taken. 
Execution of the restored core image is resumed by one'-of the Program 
Start/Restart Commands described in Paragraph 8.11 (CTRL P, CTRL T, 
or CTRL S). These commands can be issued either manually from the 
keyboard or automatically by argument in the GET command string. 

When a restored core image is to be restarted 
manually (i.e., by typing CTRL P, CTRL T, or 
CTRL S), the user should wait at least 8 sec¬ 
onds after issuing the GET to ensure the com¬ 
plete transfer of the core image before typing 
the command. 

When restoring a core image file from .DAT —14, the Monitor also 
.places the core image in the QAREA of the system device. Disk unit 
numbers other than zero must be specified in the command string. This 
permits the user to conveniently use the DUMP-program to obtain listings 
of core image files. 

Form: GET[ 


where: 

P,T,S = Perform automatic program start 

P = CTRL,P start address 
T = CTRL T start address 
S = CTRL S start address 

Note that there must be no space between GET or G 
and P, T, or S. 

If not specified, the appropriate CTRL character 
must be issued from the keyboard. 

n — System device unit number (0—7) of Disk Pack or Disk 
Cartridge QAREA to be used. If not specified, 0 is 
assumed. 



] [*_j n ] [..filnam, ext] 


J 
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filnam ext = Name and extension of core image to be re¬ 
trieved from .DAT -14. If not specified 
the contents of the QAREA are restored. 

Note: Since GET commands cause an entire core image 

to be brought in, all system conditions and 
parameters extant when core was dumped are 
restored. This includes the DATE and TIME 
.SCOM registers. 


Examples: 


I I. Restore the QAREA of the DECdisk or Disk Pack or 
Disk Cartridge unit 0 s 

type: GET^ 

or Gj 

2. Restore a core image file called DMPFIL 001 and auto¬ 
matically start at the CTRL P address: 

type: GETPu DMPFILt_j001,<s) 

3. Restore a core image file called DMPFIL 002, placing 
the core image in the QAREA of Disk Cartridge or 
Disk Pack unit 3: 

type: GET(uj3i_jDMPFILi_j002J 

Notice that a manual start must be performed, since 
P, T or S was not specified with the GET. 

8. 8 . VT15 DISPLAY COMMANDS 

The commands described in this section provide users who have configu¬ 
rations which include a VT15 Display Processor and a VT04 Display Con¬ 
sole with the ability to display any text normally directed to the 
teleprinter on the screen of the VT04 Display Console. The control 
commands are issued from the teleprinter keyboard and permit rapid 
switching between hard and soft copy output when operating with either 
the Monitor, system programs, or user programs. Up to fifty-six 72- 
character lines can be displayed. Keyboard input is echoed both on 
the display (when ON) and the teleprinter. When operated in this 
manner, the VT15/VT04 Display System functions as an extension of the 
teleprinter and communicates directly with its device handler. 


8.8.1 Operating Features 

8.8.1.1 Display Modes - Two modes of display are provided which are 
controlled by the two rightmost pushbuttons (#5 and #6) on the 

VT04 console. 


1 To operate the display as a separate I/O device, the user must use the 
software package described in GRAPHIC15 Programming Manual , DEC-15-GVTPA-A-D 




a. Continuous (Scroll) Mode - In this mode of operation, 
pushbutton #5 must be in the OFF position (i.e., not 
illuminated). Each text line is displayed on the 
screen starting at the top and progressing to the 
bottom. When 56 lines have been displayed, or the 
display buffer is full (as with HALF ON), each addi¬ 
tional line causes all displayed lines to move up 
one line position and the top line to be deleted. 

b* Paging Mode -p This mode of operation causes the dis¬ 
play to stop after 56 lines have been output, or 
the display buffer is full. The display will then 
wait for the user's signal. Paging Mode is entered 
by setting pushbutton #5 to the ON position (i.e., 
button #5 is illuminated). The next display page is 
obtained by depressing pushbutton #6 once. 

8.8.1.2 Clearing the Display Screen - The display screen can be 
erased at any time by depressing pushbutton #6 once and typing a 
Carriage RETURN. 

8 - 8 * 1 - 3 Editing - Both single characters and entire lines can be 
deleted during input from the teleprinter keyboard using the standard 
keyboard editing commands RUBOUT and CTRL U. The only difference on 
the VT is that, when using RUBOUT, no backslash ( \ ) is echoed on 
the display; the unwanted character is simply deleted. 

8-8.2 Display Command Descripti ons ., rV .* 

The following paragraphs describe the three keyboard commands required 
for operating the display. 

8o8 * 2 * 1 Y T ON/OFF - The ON argument of this command instructs the 
Monitor to load the routines which interface the VT15 to the tele¬ 
printer s device handler and set up the display buffer to the size 
specified by the HALF ON/OFF command (or its default setting). After 
this command has been typed, the user can switch at will between 
teleprinter and VT15 output using the CTRL X command described below. 
The routines and buffer space for display operation occupy either 
123 ^1,0 l° cat i° ns (when HALF is on) or 1923^ locations (when HALF is 
off). The OFF argument of this command erases the display screen and 
releases the core area occupied by the display routines and display 
buffer. 

Form: VTiuj{°JL}J 

OFF * 
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8.8.2.2 HALF ON/OFF - This command is used to set the size of the 
display buffer. This, in turn, limits the maximum number of charac¬ 
ters which can be displayed on the VTJ04 screen. The OFF argument 
permits a full size buffer to be created. The full size buffer allows 
4032i^ characters to be displayed (i.e., fifty-six 72-character lines). 

The ON argument allows only a half size display buffer to be loaded. 

A half size buffer allows 2016 characters to be displayed (e.g., 28 
72 character lines). Since most lines are not 72 characters long, 
more than 28 lines can usually be displayed with HALF ON. This feature 
is particularly useful during assembly or compiling operations when 
additional symbol table space is required. 

Form: HALF^t^y 


8 " 8 " 2 - 3 “ This command, formed by typing CTRL and X simul¬ 

taneously, alternately switches text output either to the teleprinter 
or to the VT04 screen. Once VT ON has been issued, CTRL X can be 
typed at any time (i.e., with the Monitor, a system program, or a 
user program) to change output control. An up-arrow ( t ) is echoed on 
the device to which control is transferred. 

8 " 8 " 2 ° 4 Command Default Settings - The commands VT ON/OFF and 
HALF ON/OFF can be initially set during system generation to meet 
user requirements. The default settings for the DOS-15 system as 
initially supplied are: VT OFF and HALF OFF. 

8.9 MISCELLANEOUS COMMANDS 

8.9.1 API ON/OFF 

This command controls the status of the Automatic Priority Interrupt 
System for machine configurations having this option. The ON 
argument enables the API and the OFF argument disables the API. 

Form: API 
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8.9.2 33TTY ON/OFF and LA30 ON/OFF 


This command instructs the teleprinter device handler to operate with 
hardware configurations having either a Model 33 or Model 35 terminal 
as the system teleprinter. For the 33TTY command, the ON argument 
specifies a Model 33 terminal and the OFF argument specifies a Model 
35 terminal. For the LA30 command, the ON argument specifies a 30 
CPS, LA30 console device and the OFF argument specifies a Model 35 
terminal. 



8 - 9.3 CHANNEL 7/9 

This command sets a constant in the Monitor which is used by the Mag¬ 
tape device handlers as the default operation parameter for 7- or 9- 
channel operation. Refer to the description of the Magtape handlers 
in Chapter 9 for further information. 

Form: C[HANNEL] 1 } J 

8.9.4 LP ON/OFF 

This command permits the text output resulting from the System Informa 
tion Commands REQUEST, REQUEST USER, and INSTRUCT SCOM to be output to 
a line printer, if one is available. The ON argument directs output 
to the- line printer and the OFF argument restores output to the tele¬ 
printer . 

NOTE 

For INSTRUCT and INSTRUCT ERROR: Assign 
LP to .DAT -12 to output to the line 
printer. 

Form: LP ^ {™ p } j 

8-9.5 BANK ON/OFF - PAGE ON/OFF 

These commands permit the user to select either Bank or Page Mode 
operation. In Page Mode, relocatable system and user programs (in¬ 
cluding device handlers) are loaded within 4K memory pages, and Index 
Register usage is permitted. Library routines are loaded from the 
library residing in the PAG UFD. in Bank Mode, Index Register usage 
is not permitted, and user programs (including device handlers) 
are loaded within 8K memory banks, and system library routines 
are loaded from the library contained in the BNK UFD. Either BANK 
OFF or PAGE ON sets the system to operate in Page Mode. Conversely, 
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BANK ON or PAGE OFF sets the system to operate in Bank 
Mode. 

Form: BANK ^{ ™ p } } or PAGE { °“ p } J 

8.9.6 DATE 

This command is used either to enter a calendar date or to examine 
the calendar date currently stored in the Monitor. This information 
is used by the system to indicate the date of creation of mass storage 
files. If no date has been entered into the system, each time con- 
trol is returned to the Monitor it outputs a message requesting that 
a date be entered. When a date is to be entered, the entire date 
(month, day and the last two digits of the year) must be typed. The 
DATE command with no argument causes the date currently stored in the 
Monitor to be typed out. When 2400 hours have passed, the system 
automatically requests a fresh date to be entered. The clock is 
required with the UC15 system. 

Form: D[ATEU mm [/] dd [/] yy]J 

where: 

mm = Month (.01-12) 

dd = Day of Month (01-31) 

yy = Year (70-99) 

If the slash delimiters (/) are used, leading zeroes can 
be omitted; otherwise all six digits must be typed. 

8.9.7 TIME 

This command is used either to enter or to examine the time of day 
currently stored in the Monitor. This information is updated by the 
Monitor every second. When time is to be entered, it must be typed 
as a 4 digit number (0000-2359) in 24-hour clock notation. The TIME 
command with no argument causes the current time of day (as kept in 
the Monitor) to be typed out. 

Form: T [ IME] [ ^hhmm] J 

where: 

hh = Hours (00-23) 
mm = Minutes (00-59) 
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8.9.8 TIMEST 


This command instructs the Monitor to terminate the current operation 
and restart itself after a specified time interval has elapsed. The 
command is particularly applicable when operating in Command Batching 
Mode (discussed in 8.12 ), since it permits users to unconditionally 
terminate a program's operation if its execution time exceeds that 
value expected for normal operation. The time interval can be speci¬ 
fied in minutes, seconds, or a combination of both. The maximum time 
interval (total minutes and seconds) can not exceed 131,071 seconds. 
Once executed, a TIMEST command can only be nullified by a subsequent 
LOGIN or LOGOUT command. 


1 

r mm A 

where: 

Form: TIMEST c. 

mm:s s > \ 


EUmJ \ 

: ss j * 

mm = Minutes 



1 ss = Seconds 

Example: TIMEST 

:5281 (5281 seconds) 


or 


j 

TIMEST 

88:1 (88 minutes, 1 second) 

... • v. i 


8.9.9 LOG 

This command instructs the Monitor to ignore subsequent keyboard input 
and is used primarily for making operator comments. Typing ALT MODE 
restores the keyboard for normal command input. 

Form: L[OG] j 

comment 

comment ALT MODE 

8.9.1° HALT 

This command will cause the Monitor to halt computer operation after ter' 
minal IOPS errors. Press CONTINUE, followed by CTRL P or CTRL C to con¬ 
tinue system operation. 

Form: H [ALT] j 

8.9.H CTRL D 

This command, formed by simultaneously striking the CTRL and D keys on 
the teleprinter keyboard, is used to indicate an end-of-file condition 
when the keyboard is used as an ordinary input device (as opposed to its 
being used as a command input device). CTRL D signals the teleprinter's 
device handler, or other keyboard device handler, if available, to 
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transmit a header word pair to the requesting program's I/O buffer in 
which bits 14-17 are set to the end-of-file code 0101 2 . Any informa¬ 
tion currently in the buffer is lost. In IOPS ASCII mode, therefore, 
a Carriage RETURN should always precede a CTRL D in order to assure 
output of the last line. 

8.10 SYSTEM PROGRAM LOADING COMMANDS 

The commands described in Table 8-1, System Program Loading Commands, 
are used to instruct the system loader within the Monitor to load the 
various language and utility programs which are part of the DOS-15 
Software System. Each command must be typed as shown, terminated by 
either a Carriage RETURN or ALT MODE. % 

PROGRAM START/RESTART/CONTINUE COMMANDS 

The commands described below are used to provide keyboard control 
during system and user program operation. The format of these commands 
has been previously described in paragraph 8.2.1 

8.11.1 CTRL C 

This command returns control to the Nonresident Monitor. It can be 
typed at any time, signaling the Monitor that the user wishes to abort 
a program, or enter a keyboard command. In returning control to the 
Nonresident Monitor from a previously executing program, all device 
and UFD assignments are returned to their default settings unless the 
KEEP ON command is in effect (see 8.5.2 and 8.5.3). CTRL C can also 
be used to terminate the Monitor's processing of all keyboard commands 

except for TIMEST (see 8.9.8). In this case, device and UFD assign¬ 
ments are not affected. 
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8.11.2 CTRL P 

This command restarts system programs, terminating current operation. 

Upon execution of this command, control is transferred to the 

start address specified in the last .INIT I/O Macro to the teleprinter. 

User programs may use this restart facility by issuing a .INIT macro 

Table 8-1 

SYSTEM PROGRAM LOADING COMMANDS 


Command 

Program Loaded 

F4 

FORTRAN IV compiler. 

MACRO 

MACRO-15 Assembler. 

*MAC11 

A MACRO-11 Assembler. 

EDIT 

Symbolic Text Editor. 

EDITVP 

Symbolic Text Editor for the VPi5A Display, 

EDITVT 

Symbolic Text Editor for the VT15/VT04 Display System. 

LOAD 

Linking Loader (manual program start) 

GLOAD 

Linking Loader (load and go program start) 

PIP 

Peripheral Interchange Program. 

DDT 

Dynamic Debugging Technique Program 

DDTNS 

DDT program-with no user symbol table loaded (i.e., 
octal number debugging). 

DUMP 

Program to create listing of the contents of the 

QAREA (see 8.7)... ... 

CHAIN 

Program to create a system of core overlays. 

E [XECUTE] 

Control program which supervises core residency during 
execution of a CHAIN-built overlay system. 

SRCCOM 

Source Compare Program (for comparing two ASCII files). 

MTDUMP 

Magtape user's utility program. 

DTCOPY 

High-speed DECtape copy program. 

SGEN 1 

System Generator Program. 

PATCH 2 

Mass Storage Patching Program. 

*SPOOL 1 ' 3 

SPOOLER Control Program 

UPDATE 

Program to create and update library files. 

8TRAN 

89TRAN 

Program to translate PDP-8 code to PDP-15 code. 

Program to translate PDP-8 code to PDP-9 code. 


1 This program can only be run when the user is logged-in to the 
system with the MICLOG command. 

2 When this program is used with the system device, the user must be 
logged-in under the MIC. 

3 0nly for RK based systems. 

*UNICHANNEL—15 system only 
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to .DAT-2 (which is normally permanently assigned to the teleprinter 
handler). See 6.7.6 and the description of the teleprinter handler 

m Chapter 9. CTRL P is ignored until the teleprinter handler recei' 
ves the proper .INIT. 

8.11.3 CTRL S 


This command is used to start a program loaded by the Linking Loader 
via the LOAD command. 

8. H. 4 CTRL T 

This command is used only with the DDT program and the Monitor's 
Command Batching Mode (see BATCH described below). When used with 
DDT, CTRL T terminates execution of the program being debugged and 
causes DDT to enter command mode. When used with the Monitor's 
Command Batching Mode, it causes the current job to be terminated 
and skips to the next job. 

8.11.5 CTRL R 


This command permits the user to continue program operation either 
after an I0PS4 (i/o device not ready) error occurs, or after the 
execution of a $PAUSE (see 8.12.3.4). Prior to typing this command, 
the user must first correct the condition which caused the error 
(e.g., DECtape unit incorrect, OFF LINE, etc.). 


8 ■ 12 BATCHING KEYBOARD COMMANDS 


Most of the Monitor's keyboard commands, as well as the keyboard com¬ 
mands for most system programs, can be issued from either the CR03B 
card reader or the paper tape reader. This is possible when the sys¬ 
tem is in the Monitor's Command Batching Mode. Batching Mode allows 
many programs to be run in sequence with minimum operator intervention. 
A typical sequence of operations might include file editing, assembly 
and program execution. All commands input from the batch device are 
echoed on the console teleprinter. 


8 * 12.1 Preparation 


For Command Batching Mode, 
or a deck of punched cards 


the programmer must prepare a paper tape 
which contains' the keyboard commands for 
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the operations to be performed. These commands should be in 
the same order and form as they would normally be issued from the 
teleprinter keyboard. The only exception to this is that certain job 
control commands must be inserted in the command sequence. When pre¬ 
paring paper tapes, the user will find it convenient to use the system's 
Text Editor Program EDIT. When preparing commands for input from cards, 
the user can prepare his cards using a card punch which punches either 
029 or 026 Hollerith codes (see Appendix F). 

8 -12.2 Operator Commands 

The following commands are provided for operator control: 

8.12.2.1 B A TCH. - This command is used to enter Command Batching Mode. 
Once this command is issued, the Monitor begins to read from the batch 
device specified (PR = paper tape reader, CD = CR03B card reader). 

Form: B[ATCH] ^ J 

8-12.2.2 C TR L T - This command causes the Monitor to skip to the next 
job (i.e., skip to the next $JOB job separator. See 8.12.3.1). 

8.12.2.3 C TRL C - This command is used to terminate Command Batching 
Mode operation. It operates in all other respects as it does with 
normal keyboard operation (see 8.11.1). 

8.12.2.4 CT RL R - This command is used to recover from either the 
execution of a $PA0SE (see 8.12.3.4) or an I0PS4 (see 8.11.5). 

8.12.3 Job Control Commands 

The following commands are inserted into the normal keyboard command 
sequences on the batch device medium to provide job control. 

8.12.3.1 $JP , F ~ This command separates one job from the next. (The 
loading of any system or user program constitutes a job.) The command 
operates, within the context of Command Batching Mode, in a manner sim¬ 
ilar to the CTRL C command since it causes the Batching Mode Nonresident 
Monitor to be reloaded, and all .DAT/.UFDT slot assignments to be reset 
to their default settings, if KEEP is OFF. $JOB must occur as the first 
command on the batch medium and can be used thereafter each time the 
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user wishes to exit from the current program and issue another command 
to the Monitor * 

Form: $ JOB [^comment 

where: comment = User comments 

8.12.3.2 $DATA - When the batch device is to be used for data input 
(as it might be in non-batch mode) , this command marks the beginning 

of the data. Unlike BATCH commands, data is not printed on the tele¬ 
printer. 

Form: $DATA [„ .comment!^ 

where: comment = User comments 

8.12.3.3 $END - This command follows the $DATA command and data to 
signify the end of the data. 


J Form: $END commentK 

where: comment = User comments 


8. 12 .3 . 4 $ PAUSE - This command terminates input from the batch device 
until the operator types a CTRL R. it has particular application when 
the user wishes to signal the operator to mount a DECtape, reload the 
batch device, or perform some other manual operation. 

Form: $PAUSEcommentU 

V, 

where: comment = User comments 

8 " 12 " 3 ' 5 iEXIT - This command signals the Monitor to leave Command 

Batching Mode and resume operation using commands from the teleprinter 
keyboard. 


Form: $EXIT[ comment] 


where: comment = User comments 


8-12.4 Restrictions 

When operating in Command Batching Mode, the following restrictions 
apply: 



1 
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a. The following commands are illegal: QDUMP, HALT, GET (all 
forms), PUT, BATCH, B0SS15, LOAD, DDT, API ON/OFF, DDTNS, 
MACH, SPOOL. 

b. Any ASSIGN command which references either batch device will 
automatically obtain the services of the current batch device 
handler. This is because the card and paper tape devices 
are mutually exclusive when in Batching Mode. Thus, if the 
card reader is the batch device, an ASSIGN PR -4 will result 
in the card reader assigned to .DAT -4. Functions provided 
by these handlers are equivalent to those provided in the 
PRA or CDB handlers as described in Chapter 9. 

c. When using the REQUEST command, .DAT slots assigned to the 
batch device are printed as either PR* (paper tape reader) 
or CD* (card reader) . 

d. Batching from cards is implemented only for the CR03B card 
reader. 


8.13 KEYBOARD ERROR DETECTION AND HANDLING 


The Monitor performs comprehensive error checking on all keyboard com¬ 
mands typed. Upon detection of an error, an appropriate message is 
output to the teleprinter indicating the nature of the error, and the 
remainder of the line from the error is ignored. The dollar sign ($) 
prompting symbol is then output to indicate the Monitor's readiness 
to accept another command. Keyboard errors which result during opera¬ 
tion of system programs are explained in the appropriate reference 
manual for the particular program (see Preface). Error messages which 
are prefixed by "IOPS", ".SYSLD" or ".LOAD" are listed and explained 
in Appendices D and E, respectively. 
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CHAPTER 9 


I/O DEVICE HANDLERS 

9.1 INTRODUCTION 

This chapter describes the I/O device handling routines which are sup¬ 
plied as a part of the DOS-15 system software» Included in this chap¬ 
ter are their operating characteristics and their applicability for 
use with the various language and utility programs in the DOS-15 system., 

Each I/O device handler has a unique three-character name which is used 
when assigning it to a .DAT slot via the ASSIGN keyboard command (see 
8.5,2). The first two characters of the name designate the device with 
which the handler operates. For example: DK = DECdisk; DP = Disk Pack? 
RK = Disk Cartridge; TT = Teleprinter, etc. The third character speci¬ 
fies a particular version of a handler, since some I/O devices have 
several handlers. Thus, DKA designates the "A" version of the DECdisk 
device handler. Similarly, DTC is the "C" version of the DECtape 
handler. Table 9-1 lists the standard DOS-15 I/O device handlers. 


Table 9-1 

DOS-15 I/O DEVICE HANDLERS 1 


Device Name 

. 

Version 

A 

B 

C 

D 

E 

F 

DK (DECdisk) 

/ 

/ 

/ 




DP (Disk Pack) 

/ 

/ 

/ 




RK (Disk Cartridge) 

/ 

/ 

/ 




DT (DECtape) 

/ 


/ 

/ 

/ 

/ 

TT (Teleprinter) 

/ 






PR (Paper Tape Reader) 

/ 

/ 





PP (Paper Tape Punch) 

/ 

/ 

/ 


-- 


LP (Line Printer) 

/ 






CD (Card Reader) 


/ 





VP (VP15A Display) 

/ 






MT (Magtape) 

/ 


/ 



/ 

XY (XY11 Plotter) 

V 







Users having a VT15 Graphic Display System should refer to the 
GRAPHIC15 Programming Manual (DEC-15-GVTPA-A-D) for descriptions of 
the associated device handlers VTA, LKA, and VWA. 
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The availability of several handler versions allows the user who is 
concerned with core utilization to select a particular version with the 
size and capabilities most nearly suited to his needs. Device handler 
versions differ from one another in the number of I/O functions (Macros) 
and Data Modes allowed, and in the number of files which can be accessed 
concurrently. The fewer capabilities allowed, the smaller the handler. 
"A" version handlers are the largest, but also provide the greatest 
capabilities. Other versions are more limited, and consequently are 
smaller. 


In selecting a handler, the user must consider all I/O requirements 
for the program with which it is to run. What I/O Macros and Data Modes 
are used? Is output required? How many files may be concurrently open? 
To assist the user in selecting handlers, paragraph 9.2 lists all 
versions of the handlers which can be assigned to the various .DAT 
slots used by the various DOS-15 System programs, and paragraph 9.3 
describes the specific functional characteristics of the handlers. 

9 “ 2 device handlers acceptable to system programs 1 

The following paragraphs provide listings of .DAT Slot assignments 
for the various system programs and the I/O device handlers which 
may be assigned to each. Standard assignments for the system 
initially supplied are indicated by an asterisk (*) 


1 nL C -^ V ? ntl0n I a J 1 syst ® m P r °9 ram s use .DAT -2 for command input and 
• DAT 3 for output. Both .DAT slots are permanently assigned to the 

revestJ e V£ e - / IP . uses *?e S e -DAT slots whenever teletype I/O is 
requested, thus freeing positive slots for other devices. Further, 
fh, f yst ®“ programs that require them use .DAT -11 and/or -14 for 
input, -13 and/or -15 for output, -12 for listings and -10 for 
secondary input. 



MOTE: Only one I/O handler for a particular device may be in core 

at the same time, since there is no communication between the interrupt 
handling routines. 


9.2.1 FORTRAN IV (F4) 


I .DAT Slot 

Use 

Handler j 

-13 

Output 

P p A I 

PPB 

ppc jj 

*DKA, *DPA, DTA, MTA 

DKB, DPB, 

DTD , 

dte ; 

*RKA DTF, MTF 

RKB 

-12 

Listing 

*TTA 

LPA 

VPA 

PPA 

DKA, DPA, DTA, MTA 

DKB, DPB, 

RKA DTD 

RKB DTE 

DTF, MTF 

-11 

Input 

TTA 

PRA { 

PRB 

*DKA, *DPA, DTA, MTA 1 

DKB, DPB, 

DKC, DPC, DTC, MTC 

*RKA DTD, 

RKB DTE, 

RKC DTF, MTF 


9-3 


9.2.2 MACRO-15 


.DAT Slot 

Use 


Handler 




-14 

Macro 

TTA 







Definitions 

PRA 







File 

PRB 

CDB 

*DKA, 

*DPA, 

DTA, 

MTA 

*RKA 




DKB , 

DPB, 

DTD 


RKB 




DKC , 

DPC, 

DTE 


RKC 


-13 

Output 

PPA 

PPB 

*DKA, 

*DPA 

*RKA 






DKB , 

DPB 

RKB 




-12 

Listing 

*TTA 







Output 

LPA 

VPA 

PPA, 

DPA, 

DTA, 

MTA 

! 

RKA 




DKA, 

DPB, 

DTD 


RKB 




DKB, 


DTE 


| 

1 


-11 

Input 

TTA 

PRA 

PRB 

CDB 

*DKA, 

*DPA, 

DTA, 

MTA 

j 

*RKA 




DKB, 

DPB, 

DTD 


RKB 




DKC, 

DPC, 

DTE 


RKC 


-10 

Parameter 

*TTA 







File 

PRA 






! 

Input 1 

PRB 

CDB 

DKA, 

DPA, 

DTA, 

MTA 

RKA 




DKB, 

DPB, 

DTD 


RKB 


! 


DKC, 

DPC, 

DTE 


RKC 










9 a 2 „ 3 MACH 


i 


.DAT Slot 

Use 

Handler 

-12 

Listing 

Output 

*TTA 

LPA 

VPA 

PPA, DPA, DTA, MTA RKA 

DKA, DPB, DTD RKB 

DKB, DTE 

-11 

Input 

TTA 

PRA 

PRB 

CDB 

*DKA, *DPA, DTA, MTA *RKA 

DKB, DPB, DTD RKB 

DKC, DPC, DTE RKC 
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9,2.4 FOCAL 


.DAT Slot 

1 

Use 

. 

Handler 

3 

Library 

Input 

TTA 

PRA 

PRB 

CDB 

*DKA, *DPA, DTA, MTA *RKA 

DKB, DPB, DTC, MTC RKB 

DKC, DPC, DTD RKC 

DTE 

5 1 

Library 

Output 

TTA 

PPA 

DKA, DP A, DTA, MTA RKA 

DKB, DPB, DTD RKB 

LPA, DTE 

VPA 

7 

Data File 
Input 

TTA 

PRA 

PRB 

CDB 

DKA, DPA, *DTA, MTA RKA 

DKB, DPB, DTC, MTC RKB 

DKC, DPC, DTD RKC 

DKE, DTE 

10 

Data File 
Output 

TTA 

PPA 

DKA, DPA, *DTA, MTA RKA 

DKB, DPB, DTD RKB 

LPA DTE 

VPA 


1 Prior to loading FOCAL, this .DAT 
of the devices listed, if library 


slot must be assigned to one 
output is desired. 
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9=2.5 EDIT, EDITVP, and EDITVT 


f~-—— 

.DAT Slot 

Use 

Handler j 

-15 

Scratch/ 

Output 

TTA 

VPA j 

LPA 

PPA 

*DKA, *DPA, DTA, MTA *RKA 

DKB, DPB, DTD RKB 

DTE 1 

-14 

Input 

( 

PRA 

PRB I 

CDB I 

*DKA, *DPA, DTA, MTA *RKA j 

DKB, DPB, DTD RKB ! 

DKC, DPC, DTE RKC 

-10 

Secondary 

Input 

*TTA j 

PRA | 

PRB 

CDB I 

DKA, DPA, DTA, MTA RKA f 

DKB, DPB, DTD RKB 

DKC, DPC, DTE RKC 

10 

Display 

Output 

CEDITVP only) 

* VPA J 

9o2 0 6 Linkinq I 

joader and DDT 

.DAT Slot 

Use 

Handler 1 

-5 

External 

User 

Library 

Input 

*NON j 
(same as .DAT slot -4 when used ! 
for user library) ; 

-4 

User 

Program 

Input 

PRA 

*DKA, *DPA, DTA *RKA 

DKB, DPB, RKB 

DKC, DPC, DTC RKC 

DTD 

DTE 

* 

System 

Library 

Input 

PRA 

*DKA, *DPA, DTA *RKA | 

DKB, DPB, RKB 

DKC, DPC, DTC RKC | 

DTD | 

DTE 



















9»2«.7 PIP (Peripheral Interchange Program) 

PIP uses all positive .DAT slots and -2 and -3 for TTY I/O. Prior to 
use, any non-standard device assignments should be made via the ASSIGN 
command to the Monitor. If several functions are to be used with a 
variety of peripherals, assignment of these devices all at the same 
time avoids the necessity for returning to the Monitor to reassign 
devices and for repeatedly reloading PIP after each operation that 
requires a new device. 

NOTE 

The device handlers used with PIP should normally 
be those having the greatest capability (i.e., PRA, 

PPA, DTA, DKA, etc.). If both input and output are 
to occur on the same device (e.g., DECtape), separate 
.DAT Slots must be assigned. Both .DAT Slots must 
be assigned to the same handler. 


Positive .DAT Slot assignments for the system, as initially supplied, 
are as follows; 



| .DAT Slot 

Use 

Handler 


1 

I/O 

*DKA or *DPA or *RKA 


2 

I/O 

*DKA or *DPA or *RKA 


3 

I/O 

*DKA or *DPA or *RKA 


4 

I/O 

*TTA 


5 

Input 

*PRA 


! 6 

Output 

*PPA 

. 

7 

I/O 

*DTA 


10 

I/O 

*DTA 


11 

I/O 

*NON 


12 

I/O 

*NON 


13 

I/O 

*NON 


14 

I/O 

*NON 

- . 

15 

I/O 

*NON I 


16 

I/O 

*NON | 


17 

I/O 

*NON 

l 

_ 

I/O 

*NON 


9*2.8 SGEN (.System Generator) 


1 .DAT Slot 

Use 

Handler 1 

j -14 

Input/Output 

*DKA or *DPA or *RKA 1 
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9 o 2 a 9 PATCH 


■DAT Slot Use Handler 


-14 

I/O 

— 
*DKA, *DPA , DTA, *RKA | 

DTD 

DTE 

-IF 

Secondary 

Input 

*TTA | 

PRA 

DKA, DPA, DTA, RKA ; 


9.2.10 UPDATE 


.DAT Slot 

Use 

Handler 

-15 

Output 

PPA 

PPB 

PPC 

* DKA, * DPA, DTA, MTA * RKA 

DKB, DPB RKB 

-i4 

Input 

PRA 

*DKA, *DPA, DTA, MTA *RKA 

DKB, DPB RKB 

DKC, DPC RKC 

] -12 

——- 

Listing 

LPA 

*TTA 

VPA 

PPA 

DKA, DPA, DTA, MTA, RKA 

DKB, DPB RKB 

-IF 

Secondary 

Input 

*TTA 

PRA 

DKA, DPA, DTA, MTA, RKA 

DKB, DPB RKB 

DKC, DPC RKC 

9„2 a 11 DUMP 


■DAT Slot 

Use 

Handler 

-14 

Input 

*DKA, *DPA, *DTA, MTA, *RKA 

DKB, DPB, DTD RKB 

DKC, DPC, DTE RKC 

-12 

Listing 

*TTA j 

LPA 1 

VPA 1 

PPA 

DKA, DPA, DTA, MTA, RKA 

DKB, DPB, DTD RKB 

DTE 
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9.2.12 CHAIN 




.DAT Slot 

Use 

Handler 

-5 

User 

Library 

*NON 

(Same 

as .DAT slot -4 

when used) 

-4 

■ 

Input 

PRA 
*DKA, 
DKB, 
DKC , 

*DPA, 
DPB 
DPC , 

DTA, *RKA, 

RKB 

DTC, RKC, 

DTD 

DTE 

MTA ( Use only j 

if no otherj 
MTC < DT, DK, or | 
1 MT is as- j 
V. signed. ; 

»i i 

i 

i 

i 

j 

System 

Library 

Same 

as for 

.DAT -4 

... | 

I 

S 

. ...■ . i 


NOTE 

Use the smallest handlers possible since they are not recoverable 
as user handlers in the overlay system. 


9.2.13 EXECUTE 


—\ 



.DAT Slot 

Use 

Handler 

-4 

Load 

CHAIN-Built 

Program 

PRA 

*DKA, *DPA, DTA, *RKA, MTA 

DKB, DPB RKB r' Use only if 

DKC, DPC, DTC, MTC J not shared 

DTD \ with overlay 

DTE system 


9.2.14 SRCCOM (Source Compare) 


.DAT Slot 

Use 

Handler 

-15 

Old File 

TTA 

(if not assigned 

to -14) 


Input 

PRA 

(if not assigned 

to -14) 



CDB 

(if not assigned 

to -14) 



*DKA, 

*DPA, DTA, 

MTA, *RKA 



DKB, 

DPB, DTD, 

RKB 



DKC, 

DPC, DTE 

RKC 

-14 

New File 

TTA 

(if not assigned 

to -15) 


Input 

PRA 

(if not assigned 

to -15) 



CDB 

(if not assigned 

to -15) 



*DKA, 

*DPA, DTA, 

MTA, *RKA 



DKB, 

DPB, DTD 

RKB 




DTE 
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SRCCQM (Source Compare) Cont„ 


«DAT Slot 

Use 

Handler 

-12 

| 

i 

1- 

Listing 

*TTA 

PPA 

LPA 

VPA 

DKA, DPA, DTA, MTA, RKA 

DKB, DPB, DTD, RKB 

DTE 


9.2. 15 DTCOPY (DECtape Copy) 


.DAT Slot 

Use 

, j 

Handler ! 

-15 

Output 

DTA 



DTD 



DTE 

-14 

Input 

DTA 



DTD 



DTE | 




9.2.16 8TRAN (PDP-8 to PDP-15 Translator) 
89TRAN (PDP-8 to PDP--9 Translator) 


.DAT Slot 

Use 

Handler 

-15 

Input 

PRA 

CDB 

TTA 

*DKA, *DPA, DTA, MTA *RKA 

DKB, DPB, DTD RKB 

DKC, DPC, DTE RKC 

-14 

| 

Output 

PPA 

LPA 

TTA 

VPA 

*DKA, *DPA, DTA, MTA, *RKA 

DKB, DPB, DTD RKB 

DTE 


% 




1 Prior to program loading, 
both .DAT slots. 


one of these handlers must be assigned to 
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9• 2 •1 7 MTDUMP (Magtape User 1 s Utility Program) 


•DAT Slot 1 

Use 

Handler ' J 

1 

Input 

MTA, 

MTF > 


3 

Output 

MTA, 

MTF, TTA 



9.2.18 SPOOL 


.DAT Slot 

Use 

Handler 

NONE 




9-3 I/O HANDLER DESCRIPTIONS 

The following paragraphs describe the operating features of the standard 
DOS-15 I/O Device Handlers. The DOS-15 System Manual (DEC-15-0DFFA-B-D) 
describes functions which are internal to the handlers and provides 
instructions to assist users in creating their own special device hand¬ 
lers. users having a VT15 Graphics Display System should refer to 
the GRAPHI C15 Programming Manual (DEC-15-GVTPA-A-D) for descriptions of 
the associated device handlers VTA, LKA, and VWA. 


1 Prior to loading this program, the .DAT slots must be reassigned to 
one of the handlers listed here. 
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9.3.1 Teleprinter Handler (TTA) 


9.3.1.1 General Description - The teleprinter handler is embedded in 
the Resident Monitor and provides all functions necessary for tele¬ 
printer input/output. The handler performs I/O using either IOPS ASCII 
(Mode 2) or Image Alphanumeric (Mode 3) data. Table 9-2 lists the 
handler's responses to the various I/O Macros. 

Table 9-2 


TELEPRINTER I/O FUNCTIONS 


Macro 

Response 

.INIT 

Accept 

.FSTAT 

Ignore 

.RENAM 

Ignore 

.DLETE 

Ignore 

.RAND 

Illegal 

.RTRAN 

Illegal 

.SEEK 

Ignore 

.ENTER 

Ignore 

.CLEAR 

Ignore 

.CLOSE 

Accept 

.MTAPE 

Ignore 

.READ 

Accept 

.WRITE 

Accept 

.WAIT 

Accept 

.WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (I0PS6) 

9 " 3 - 1 * 2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the teleprinter 
handler in its response to certain I/O Macros and characters: 

a. .INIT 1) Maximum I/O buffer size returned: 42 0 (34 ) 

8 10 

21 Set up.CTRL P restart address from address 
specified in .INIT argument "restrt". Refer 
to the DOS-15 System Manual (DEC-15-ODFFA-B-D) 
for setup of the restart addresses for CTRL C 
and CTRL T. 

3) Output Carriage RETURN/LINE FEED 
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b. .CLOSE - Output Carriage RETURN/LINE FEED. 

c. .WRITE - When in IOPS ASCII Mode a LINE FEED is normally 

output automatically before the line (logical 
record) is output unless an Overprint (20) is 
the first character (see Table 9-3). 

d. Non-Printing Function Characters - The non-printing 

function characters contained in Table 9-3 
have special significance when input and out¬ 
put in IOPS ASCII mode. 


Table 9-3 

SPECIAL NON-PRINTING FUNCTION CHARACTERS FOR IOPS ASCII TELEPRINTER I/O 



FUNCTION 

(ASCII in parentheses 

TRANSFER 
) DIRECTION 

ACTION 


Carriage RETURN 
(015) 

Input 

Insert all characters typed, includ¬ 
ing this Carriage RETURN, since the 
last Carriage RETURN or ALT MODE, 
into the requesting program's I/O 
Buffer. Echo a LINE FEED on the 
printer. 



Output 

Terminate output of the contents 
of the requesting program's I/O 
buffer. Output Carriage RETURN. 


ALT MODE 
(33, 175, 176) 

Input 

; .."V" 

Terminate the current line and in¬ 
sert all characters typed since the 
last Carriage RETURN or ALT MODE into 
the requesting program's I/O buffer 
Map into the I/O Buffer as 175. 



Output 

Terminate output of the contents of 
the requesting program's I/O buffer. 

f" 

LINE FEED 
(012) 

Input ■■ 

Insert in requesting program's I/O 
buffer. 


Output 

Ignore if this is the first charac¬ 
ter in the I/O buffer; otherwise, 
output. 


VT (Vertical Tab) 

(013) 

Input 

-—-- ...___ 

Insert in requesting program's I/O 
buffer. .,. n y/v-vu . ■ : 


.FORM Feed 
• (014) 

Output 

Model 35 teleprinters output FORM 

Feed. 

Model 33 and LA30 teleprinters ignore. 
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Table 9-3 (Cont.) 


FUNCTION 

(ASCII in parentheses.) 

TRANSFER 

DIRECTION 

ACTION 

] 

I Horizontal TAB 
(011) 

Input 

Output 

Insert in requesting program's I/O 
buffer. 

Model 35 teleprinters output TAB 
(011). 

Model 33 teleprinters output suffi¬ 
cient number of SPACES (040) to 
position printer at columns 9, 17, 

25,... etc. 


Skip One Line 
(021) 

Output 

Only 

If this is the first character in the 
requesting program's I/O buffer, skip 
1 line. Otherwise, ignore. 


Overprint 

(020) 

Output 

Only 

If this is the first character in the 
requesting program's I/O buffer, 
suppress the LINE FEED normally out¬ 
put. Otherwise, ignore. 


RUBOUT 

(177) 

Input 

Delete the last character typed 
previous to this and echo a backslash 
( \). 


JCTRL U 

(025) 

Input 

Output 

Delete all characters typed since 
the last Carriage RETURN or ALT 

MODE, and echo an "at" sign ( @ ). 

If typed while output is under way, 
truncate the remainder of the logical 

record being output. 

* & 


Null 

(000) 

Input/ 

Output 

Ignore 


(CTRL D 

(000) 

Input 

Transmit to the requesting program's 
I/O buffer a logical record which 
consists of a header word pair only, 
with the I/O Mode Bits (14-17) set 
to 0101 to indicate end-of-file. 

(See paragraph 6.3.1.1.) 



Progra m Control Characters - The teleprinter retains its role 
as control device during all I/O operations. The CTRL characters 
(CTRL C, CTRL P, CTRL S, and CTRL T) are recognized when typed, regard- 
less of Data Mode or transfer direction. These characters perform 
specific system functions as described in 8.1 . Experienced users who 
wish to alter their meaning may do so using procedures described in 
the DOS-15 System Manual (DEC-15“0DFFA-B“D)» 
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9-3.2 Paper Tape Punch Handlers (PPA, PPB, and PPC) 

9 “ 3 ' 2 ” 1 General Description - There are three paper tape punch 
handlers: PPA (571g registers), PPB (4 1 6g registers), and PPC (322 

registers). All three handlers respond identically to the I/O 
Macros, but differ as to the various data modes which are acceptable 
to them. Table 9-4 lists the data modes which are acceptable and 
Table 9-5 shows the handlers' responses to the I/O Macros. 

Table 9-4 


PAPER TAPE PUNCH DATA MODES 


Data Mode . 

Handler 

| PPA 

PPB 

PPC 

IOPS ASCII 

X 

- 

_, 

IOPS Binary 

X 

X 

X 

Image 

Alphanumeric 

X 

X 

■ V — 

Image Binary 

X 

X 

- 

Dump 

X 

X 

- 


Table 9-5 


PAPER TAPE PUNCH I/O FUNCTIONS 


Macro 

Response 

. INIT 

Accept 

.F STAT 

Ignore 

•RENAM 

Ignore 

.DLETE 

Ignore 

.RAND 

Illegal 

.RTRAN 

Illegal 

. SEEK 

Illegal 

.enter 

Ignore 

.CLEAR 

Ignore 

.CLOSE 

Accept 

.MTAPE 

Ignore 

.READ 

Illegal 

.WRITE 

Accept 

.WAIT 

Accept 

•WAITR 

Accept 

.TRAN 

Illegal 


Illegal - Illegal Function (I0PS6 Error) 
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9.3.2.2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the Paper Tape Punch 
Handlers in their response to certain I/O Macros and characters. 


a. .INIT 


1) Maximum I/O buffer size returned: 64 c (52, n ). 

o 10 

2) Punches two fanfolds of leader. 


b. .CLOSE— 1) Output EOF (end—of—file) header word pair 
(see 6.3.1.1) as last record on the tape. 

2) Punches two fanfolds of trailer. 


c. Special Characters - The characters listed in Table 9-6 
have special significance to the handlers 
when output in IOPS ASCII Mode. These char¬ 
acters, except TAB, are ignored if they do 
not appear as the first character in a logi¬ 
cal record (line). If a LINE FEED, VT (Verti¬ 
cal Tab), or FORM Feed does not appear as the 
first character in a logical record, a LINE 
FEED is supplied by the handlers. 





Table 9-6 

SPECIAL FUNCTION CHARACTERS FOR FIRST CHARACTER IN LINE 



LINE FEED 

( 012 ) 

VT (Vertical TAB) 

( 013 ) 

FORM Feed 
(014) 

Horizontal TAB 

( 011 ) 


ACTION' 


Output, 


Output, followed by four RUBOUTs 1 (177) 


Output, followed by 40 Nulls 1 (000). 


Output, followed by one RUBOUT 1 (177) 




9 “ 3 ‘ 3 Pa P er Tape Reader Handlers (PRA and PRB) 

There are two paper tape handlers: PRA (673 g registers) and PRB (446g 
registers). Both handlers respond identically to the I/O Macros, but 
differ as to the data modes which are acceptable. Table 9-7 lists the 
data modes which are acceptable, and Table 9-8 shows the handlers 5 re¬ 
sponse to the I/O Macros. 


The RUBOUT and NULL functions which follow output of the desired char- 
acters are used for hardware timing purposes when the paper tape is 
to be transmitted to a printer in an off-line environment. 
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Table 9-7 


PAPER TAPE READER DATA MODES 


Data Mode 

Handler 

: PRA 

PRB 

IOPS ASCII 

X 

X 

IOPS Binary 

X 

- 

Image 

Alphanumeric 

X 


Image Binary 

X 

- 

Dump 

X 

- . 


Table 9-8 


PAPER TAPE READER I/O FUNCTION 


Macro 

Response 

. INIT , . 

Accept 1 

.FSTAT 

Ignore 

.RENAM 

Ignore 

.DLETE 

Ignore 

.RAND 

Illegal 

'■ . RTRAN 

Illegal 

.SEEK 

Ignore 

.ENTER 

Illegal 

.CLEAR 

Illegal 

.CLOSE 

... Accept . / ; 

.MTAPE 

Ignore 

.READ 

Accept 

.WRITE 

Illegal 

.WAIT 

* Accept 

.WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (IOPS6 Error) 


1 Maximum I/O buffer size returned: 64 0 (52 ) . 

8 10 





9.3.4 DECtape Handlers (DTA, PTC, DTD, DTE, and DTF), 


9.3.4.1 General Description - There are five DECtape handlers for 
TU55/TU56 DECtape operation: 

■ • DTA (2766g locations) is the most general DECtape 
handler provided. It has a simultaneous three- 
file capacity, either input or output. Input files 
can be referenced on the same or different DECtape 
units; however, not more than one output file can 
exist on the same unit. (I.e., file creation on 
the same unit must occur sequentially.) 

• ETC (1264g locations) is the most limited and also 
the most conservative of core (for IOPS data mode 
operations) of the handlers. It is an input only 
handler with a one-file capacity. 

® DTD (3071g locations) provides single file operation, 
either input or output. 

® DTE (2674g locations) is similar to DTD, differinq 
only in its I/O function capabilities as shown In 
Table 9-10. 

® DTF Cll51g locations) is a handler which simulates 

the non-directoried, sequential access file structure 
of Magtape. It accommodates (serially) up to eight 
DECtape units, both input and output. When the last 
block of a tape on a particular unit has been accessed, 
DTF causes the Monitor to output an IOPS4 message 
(Device Not Ready) to permit the operator to remove 
the current tape from the DECtape drive and mount 
another. The operator can then type a CTRL R to con¬ 
tinue processing. 


Table 9 9 illustrates the data modes which are acceptable to these 
handlers, while Table 9-10 shows the handlers’ responses to the vari 
ous I/O Macros. 


Table 9-9 

DECTAPE DATA MODES 


| " Data Mode 

Handler 

DTA 

DTC 

... 

DTD 

DTE 

DTF | 

IOPS ASCII 

X 

X 

X 

X 

X 

IOPS Binary 

X 

X 

X 

X 

X 

Image 

Alphanumeric 

X 

— 

X 

X 

— 

Image Binary 

X 

- 

X 

X 

- 

Dump 

X 

— 

X 

X 
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9-3.4.2 Device Dependent Characteristics - The following character¬ 
istics are unique to the DECtape Handlers in their responses to certain 
I/O Macros. 

a. .INIT - Maximum I/O buffer size returned: 377 0 (255, A ). 

O 10 

b. .MTAPE 1) DTD accepts REWIND and BACKSPACE RECORD 

subfunctions only. 

2} DTF accepts REWIND, BACKSPACE RECORD and 
SKIP RECORD subfunctions only„ 


Table 9-10 


DECTAPE I/O FUNCTIONS 



9 «3.5 DECdisk, Disk Cartridge and Disk Pack Handlers (DKA/RKA/DPA, 
DKB/RKB/DPB, and DKC/RKC/DPC) 

9.3.5.1 General Description - Three handlers are provided for RF15 
DECdisk, RK05 Disk Cartridge and RP02 Disk Pack operations. Version 
for version, these handlers are identical in their functions with 
these two exceptions: 

a. All disks DECdisk, Disk Cartridge and Disk Pack are 
block addressable for direct access operations 
(.TRAN and .RTRAN Macros) in addition to the DECdisk 
provides word addressability. 




b. The Disk Pack and Disk Cartridge have a unit structure 
while the DECdisk does not* This means that each DECdisk 
is treated as a single addressable unit regardless of the 
actual number of platters incorporated (up to 8) * 


All versions of these handlers support the disk file structures de¬ 
scribed in Chapter 3. There is no fixed limit to the number of input 
or output files which can be simultaneously accessed, except as deter¬ 
mined by the amount of available buffers. To this end, the handlers 
perform dynamic buffer allocation from the Monitor's buffer pool, using 
the .GTBUF and .GVBUF Monitor Macros described in Chapter 5. At run 
time, the operator need only be concerned that the number of files con¬ 
currently accessed is not greater than the number of buffers allocated 
by the BUFFS Keyboard command (see 8.6.1). 

The following commands obtain buffers from the pool, and return them 
immediately upon completion of the operation: 

.DLETE 
.RENAM 
•CLEAR 


The following commands obtain a buffer from the pool and do not return 
it until a subsequent .CLOSE, .INIT or Rewind (.MTAPE) is performed: 


.FSTAT 
• ENTER 
. SEEK 
.RAND 


The following commands return a buffer to the pool, if any were taken 


. INIT 
.CLOSE 

.MTAPE (.Rewind subfunction} 

The handlers operate in all-data modes (i.e., IOPS, Image, and Dump). 

Table 9-11 lists the I/O Macros which are acceptable to the various 
handler versions. 
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Table 9-11 


DECDISK, DISK CARTRIDGE AND DISK PACK I/O FUNCTIONS 



9.3.5.2 Device Dependent Characteristics - The following character¬ 
istics are unique to these handlers in responding to certain I/O Macros; 







a. 


INIT 


1 ) 

2 ) 


376 8 ( 254 10 ). 


3). 


4) 

5) 


Maximum I/O buffer size returned; 

The disk handlers allow write verification on output files. 

If the file is defined as an output file, the user has the” 
opportunity of guaranteeing the integrity of his data by 
using ll g as the "dd" argument to the .INIT macro. The 
handler • will then check every block of data it writes 
out, to ensure that the transfer occurred without error. 

A second .INIT command must be executed to remove or add 
the write checking feature. (i„e., repeated llg argument 
causes write check switch 1 to be turned ON/OFF/ON/OFF/ON.,) 

°^ tpu ^ f i le , alread y opened on a .DAT slot referenced by 
* W1 H be deleted. If a .INIT references a .DAT slot 
with an opened input file, the handlers will close it 
and give back the buffer it was using. 

Control is retained until all necessary I/O is complete. 

The .INIT macro uses the relationship between the User 
? ireCt ° ry Table and the Device Assignment Table to 
get the correct UIC from the User File Directory Table. 

user c hanging UIC's under program control (via 
’ US ™ ™ acros) ' the operation must be accomplished before 
a .INIT in order to obtain the desired UFD. 
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. DLETE 


1) Control is not returned until all necessary Disk I/O is 

complete. If the UIC associated with this .DAT slot 
does not exist in the MFD, or if the named file can not 
be found, the disk handlers ignore this macro. If the 

name is found, the handlers return the first block num¬ 
ber of the file in the AC. The buffer used by the hand¬ 
lers to delete the named file is given back to the buf¬ 

fer pool upon completion of the .DLETE. 

2) The .DLETE macro follows the protection rules for di¬ 
rectory modification. That is, .DLETE will not work on 
a protected directory, but returns an IOPS 63 error. 

.RENAM 

1) The first block number of the renamed file is returned 
in the AC after a successful operation. If the file or 
UFD does not exist, the handlers return to LOC+3 with 

0 in the AC. .RENAM changes the renamed file's date to 
the current date (maintained by the DATE keyboard command 
described in Chapter 8). 

2) At completion of the .RENAM function, the handlers re¬ 
turn the buffer to the buffer pool. 

3) The .RENAM macro follows the protection rules for 
directory modification. That is, .RENAM will not work 
on a protected directory (IOPS 63) . 

.ENTER 

1) The handlers check for directory protection. If any of 
the following conditions is satisfied, the handlers will 
allow successful operation. If none is satisfied, the 
handlers will terminate with an IOPS 63. 

Conditions for gaining UFD access: 

Entry in .UFDT equals the logged-in UIC 

Logged-in UIC equals MIC 

Directory protection code equals 0 

2) Once the entry in the UFD has been made via the .ENTER, 
the file is defined as being opened and truncated. Upon 
a subsequent .CLOSE, the file will exist as a closed 
file, but not truncated. 

3) When a .ENTER is done with a file name that already 
exists, the old file is deleted only after the new 
file (just .ENTERed) is .CLOSEd, if the old file is not 
truncated. If the old file is a truncated file, it is 
deleted immediately, before the new file is listed in 
the UFD. The process of deletion of identically named 
truncated files continues until a non-truncated file 
with the same name is found. At this point, the new 
directory entry is made. Truncated files which follow 
are not deleted. In all cases, UFD searches are 
sequential starting at the beginning. 




.CLEAR 

1) The disk handlers will not honor .CLEAR unless the user 
has logged in under the MIC. The .CLEAR function deletes 
all files and directories on the entire disk. All bit maps 
are closed and indicate only the space which they occupy. 
The MFD will have no UFD's, SYSBLK or BAT. An I/O buffer 
is obtained from the pool for this operation and is subse¬ 
quently returned on its completion. 

•CLOSE 

11 On input, the handlers give the buffer back (if 

one was acquired) and make the .DAT slot available 
for subsequent .INITs. On output, the handlers 
write an end-of-file record (if the user did not 
already write one), and then proceed as on input. 

•READ w 

1) All .READ commands executed after an end-of-file 
(EOF) header has been reached will return an EOF 
in header word 0 (.001005) . 

.MTAPE 

1) DKA, RKAand DPA.accept the REWIND and BACKSPACE 

subfunctions during input only. REWIND is effectively 

_ rr.n.Qp 


. TRAN 


1) The .TRAN is not included as part of the disk file 
structure. That is, all blocks read or written are 
done so at the user's discretion. MFD's, UFD ' s , 

Bit Maps, and RIB's are not considered, and are not 
protected from the .TRAN macro. The .TRAN macro is 
allowed to any .DAT slot that has been .INITed, and 
not .CLOSEd or rewound (via a .MTAPE). 


^ F ? r . tlle DECc3 -isk, the user can reference a specific 
platter just by identifying the block number he 
wants. The block numbers and platter relationships 
are shown below: 


Platter Number 

0 

1 

2 

3 

4 

5 

6 

7 Ti; 

.FSTAT 


Block Number 

0-1111 

2000-3171 

4000-5111 

6000-1111 

10000-11111 

12000-13111 

14000-15111 

16000-11717 


1) 


to^f-if« n ? tl0 2 S ? ormall Y' except that a subsequent .SEEK 

access :f ST “ wil1 not require redundant disk 

access. That is, both .FSTAT and .SEEK ordinarily reauirp 

a mxnrjnum of three disk accesses - one to thJ one to 

an exist-inni?? 8 tC n h t flle ' If the USer does a * FSTAT to 
le ' and ^ hen a - SEEK ' the disk handlers 

disk access! Sucoess£ul -FSTAT, and do not do an extra 



k. .RAND 

1) .RAND commands to a nonexistent file cause an I0PS13. 

Those to a nonexistent UFD cause an I0PS51. Those to 
an empty UFD cause an I0PS71. 

l. .RTRAN 

1). The disk pack and disk cartridge handlers ignore the 
word number argument (assumed to be 0) and return the 
whole blocks If the word number plus the word count 
exceeds 254 1Q , the disk handlers will return IOPS67„ 

Output .RTRAN to the RP or RK disk requires 256 ln -word 
buffers to allow the handlers to supply the correct 
links in the last two words,, (Otherwise, random 
files would require two buffers from the pool.) 

If the block number argument requested by the .RTRAN 
is less than one, or greater than the number of blocks 
in the file, an IOPS66 will result. 

9.3.6 Magtape Handlers (MTA, MTC, and MTF) 

9.3.6.1 General Description — Three handlers are provided for operation 
of Magtape drives TU10, TU20A, TU20B, TU30A, and TU30B. These handlers 
permit control of up to eight transports. 







MTA (4705g locations) is the most general and permits 

DECtape file structuring using .SEEK and .ENTER Macros 
(refer to Chapter 4). Up to three files can be con¬ 
currently referenced, each on a different transport, 
either input or output. 




• MTC (1253g locations) is a read-only handler designed 
for operation using DECtape file structuring only. 

It has a single file capacity; sequential file refer¬ 
ences are, of course, allowed. 

• MTF (1312g locations) is designed for Magtape file 
structuring, only. It accommodates up to eight con¬ 
currently referenced transports, both input and output. 

The track count (either 7- or 9-channel) can be set at System Genera¬ 
tion, or by using the CHANNEL Keyboard Command. In addition, it can 
also be set dynamically, along with parity and recording density param¬ 
eters, using the .MTAPE I/O Macro (see paragraph 6.7.7) when using 
Magtape file structuring. When using DECtape file structuring, parity 
and density are fixed at odd parity and 800 BPI recording density. 


Table 9-12 lists the Data Modes acceptable to the handlers and Table 
9""13 lists the I/O Macros and their responses. 
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Table 9-12 


MAGTAPE DATA MODES 


Data Modes 

Handler ”*1 

MTA 

MTC 

MTF 

IOPS ASCII 

X 

X 

X 

IOPS Binary 

X 

X 

X 

Image 

Alph anumeric 

X 

- 

— 

Image Binary 

X 

- 

- 

Dump 

X 

- 

1 


Table 9-13 

MAGTAPE I/O FUNCTIONS 


Macro 

Handler 

MTA 

MTC 

MTF i 

. INIT 



Accept 

Acc 

:ept 

.FSTAT 

Acc 

^ept 

i 




.RENAM 



Ills 

gal 



.DLETE 

' ',.y 

F 





.RAND 

Ills 

V 

sgal 



Ills 

gal 

.RTRAN 

Illegal 

k 

1 




.SEEK 

i 

i 

Accept 



.ENTER 



Illegal 



.CLEAR 



Illegal 

1 

? 

.CLOSE 



Accept 

V 1 

Accept I 

.MTAPE 

Acc 

apt 

Illegal 



.READ 



Accept 



.WRITE 



Illegal 



.WAIT 



Accept 



i .WAITR 



Accept 



.TRAN 

1 

i 

Illegal 


F 1 


Illegal = Illegal Function (I0PS6 Error) 






















9-3.6.2 Device Dependent Characteristics - The first .INIT to a Magtape 
unit causes the system default parameters for track count, recording 
density, and parity to be assigned as follows: 

Parity odd Density 800 BPI 

Track Count - System Generated Default unless otherwise speci¬ 
fied in the CHANNEL Keyboard Command. (See Paragraph 8.9.3.) 

The following characteristic is unique to the operation of the A and 
C handlers in responding to the I/O Macros below: 

a. .INIT - Maximum I/O buffer size returned: 376 (254 ). 

8 10 


The following characteristics are unique to the operation of the MTF 
handler: 

a. .INIT - Returns standard buffer size of 377 g . 

b. .MTAPE - On functions 05, 06, and 07 (skip record, skip 
file, and skip to logical end-of-tape), if the handler 
senses physical end-of-tape, IOPS 65 is issued. 

c. .READ - Bad Tape and Data Late errors are considered un¬ 
recoverable and MTF issues IOPS 65 for them. 

d. .TRAN - Permits either the PDP-15 standard 18-bit transfer 
(both 7 and 9 track look like 7 track) or the industry stan¬ 
dard 9-track transfer. In true 9-track operation, entered 
by setting bit 6 of the CAL to 1, each 18-bit word is in¬ 
terpreted as two 8 bit bytes of data plus associated parity 
bits (which are set on output and checked on input by the 
hardware). Thus: 

A parity Byte A Byte B 



0 1 2-9 10 - 17 

B parity—^ 

9.3.7 Line Printer Handler (LPA) 

9.3.7.1 General Description - LPA (533 g ) locations for the LP15 ver¬ 
sion and 657 g locations for the LPll version are designed to operate 
the 80-column and 132-column LP15 and LPll Line Printers respectively. 
The handlers accept data in either IOPS ASCII or Image Alphanumeric 
data modes. Table 9-14 lists the various I/O Macros and the handlers’ 
response to them. 

Table 9-14 


RESPONSES TO LINE PRINTER I/O FUNCTIONS 


Accept 

Illegal 
(IOPS 6) 

Ignore 

. INIT 

. RAND 

. FSTAT ! 

.CLOSE 

.RTRAN 

.RENAM 

.WRITE 

. SEEK 

.DLETE 

.WAIT 

.READ 

.ENTER 

.WAITR 

.TRAN 

.CLEAR 



.MTAPE 








9.3.7.2 Device Dependent Characteristics - The following paragraphs 
describe characteristics which are unique to the Line Printer Handler 
in its response to certain I/O Macros and characters. 



a. .INIT - 1) Maximum I/O buffer size returned; 70g (56, n ) for 

132 column printers; 44 g (36, n ) for 80 column 
printers. iU 

2) Output FORM Feed. 

3) Test Bit 6 of the .INIT CAL (see 6.7.6). If this 
bit is zero, the handler will perform automatic 
paging by outputting a form feed after every 57, n 
lines. (This bit is set by using a 5 rather than 
a 1 in the "dd" argument of the .INIT.) 

b. .CLOSE - Output a FORM Feed (if not inhibited in the .INIT)• 

c. .WRITE - 1) Examine header word 0 in the user's I/O 

buffer as follows: 

Bit Meaning 

0 0 = Enter Single Line Mode 

1 = Enter Multiple Line Mode 

1-8 Contains Line Count for 

Multiple Line Mode 

14-17 Data Mode 

2 = IOPS ASCII 

3 = Image Alphanumeric 

21 Check the first character of the user's I/O 
buffer for the following vertical form con¬ 
trol characters, all of which are output 
by the FORTRAN IV Object Time System: 

,, 014 FORM Feed 

020 Overprint 

021 Print every second line 

012 Line Feed 

To effect the Overprint function for FORTRAN 
. users, it is necessary to simulate certain 
vertical form control characters. If the 
first character of a line is 012, 014, or 021, 
the handler automatically enters Multiple Line 
Mode (by setting bit 0 of the first word in 
the user's I/O buffer to 1) and prints two 
lines, the first line being the vertical con¬ 
trol character, and the second line being the 
actual data. If the first character is 020 
(overprint), it is replaced in the user's 
I/O buffer by 015 (Carriage Return) which 
does not affect the page position and both 
lines are printed. All other characters cause 
a Line Feed to be output from the handler's 
internal buffer followed by the line from the 
user's buffer. After output, any data in the 
user's I/O buffer which was changed (i.e., header 
word 0 or the first data word) is restored. 
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If the user intends to output to another device 
from the same I/O buffer (e.g., two sequential 
.WRITEs), a .WAIT should be used after the .WRITE 
referencing the Line Printer to permit the re¬ 
storation of any data which may have been replaced 
in the user’s I/O buffer by LPA. 

3) Output in either Single Line Mode or Multiple 
Line Mode as applicable. 

41 Restore modified portions of the user’s I/O 
buffer (if changed). 

d. Carriage Control Characters - The control characters in Table 
9-15, except horizontal TAB, cause line termina¬ 
tion, in both IOPS and Image Modes, except for 
special cases described under .WRITE above. 


Table 9-15 


LINE PRINTER CARRIAGE CONTROL CHARACTERS 


Character 


Line Feed (012) 

VT (Vertical Tab) (013) 
Form Feed (014) 

Carriage Return 0215) 

*\ 


DLE (020) 
DC1 (021) 


Refer to Appendix 


DC2 (022) > A for alternate 


designations 


DC3 (023) 

DC4 (024) j 
ALT MODE (175) 


Horizontal Tab (011) 



Action 


Space one line 

Space 20 lines 

Move to top of form 

Reset column count to zero (no 
implicit LINE FEED function) 

Space 30 lines 

Space 2 lines 

Space 3 lines 

Space 1 line 

Space 10 lines 

Reset column count to zero (no 
implicit LINE FEED function) 

Output sufficient number of spaces 
to position printer at column 9, 
17, 25,...,etc. This is not a 
line terminator and may occur any¬ 
where in the line. 



9.3.8 Card Reader Handler (CDB) 


9-3.8.1 General Description - CDB is designed to operate the CR03B 
(770g locations), CR15 (1000g locations) and CR11 613g locations) 
card readers respectively. The handler transmits data in IOPS ASCII 
mode only. As initially supplied, it interprets Hollerith code as 
punched in DEC029 Card Code. CDB is also supplied in source form 



which can be assembled to produce a version of the handler which in¬ 
terprets Hollerith punched in DEC 026 Card Code 1 . Appendix F contains 
a table of 029 and 026 Hollerith Codes and the corresponding IOPS 
ASCII codes. Table 9-16 lists the handler's response to the various 
I/O macros. 

Table 9-16 


CARD READER I/O FUNCTIONS 


Macro 

Response 

.INIT 

Accept 

.FSTAT 

Ignore 

.RENAM 

Ignore 

.DLETE 

Ignore 

.RAND 

Illegal 

.RTRAN 

Illegal 

. SEEK 

Ignore 

.ENTER 

Illegal 

.CLEAR 

Illegal 

.CLOSE 

Accept 

, .MTAPE 

Ignore 

. READ 

Accept 

= .WRITE. 

Illegal 

.WAIT 

Accept 

.WAITR ' 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (IOPS6 Error) 

9 * 3 ' 8 * 2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the Card Reader Handler 
in its response to certain I/O Macros. 

Maximum I/O buffer size returned: 44 0 (36..) 

Eighty card columns are read and interpreted 
as 029 or 026 Hollerith data, mapped into the 
corresponding 64-graphic subset of ASCII, and 
stored in the user's I/O buffer in 5/7 format 
(36fo locations are required to store an 80 
column card). Compression of internal blanks 
to tabs and truncation of trailing blanks is not 
performed (all 80 characters appearing on the 
card are delivered to the user's buffer). In 
addition, a Carriage RETURN (015) character is 
appended to the input line; thus, a total of 81 
characters are returned to the user. 


, ? ef ®^ to t ; he £GEN manual for procedures for assembling and installing 
the 026 code version of CDB. 


a. .INIT - 

b. .READ - 
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c. Illegal punch configurations - all illegal punch configura¬ 

tions (i.e., those not appearing in the 029 or 
026 character set shown in Appendix F) are in¬ 
terpreted as validity errors and will cause an 
IOPS 4 error condition. The card containing 
the error must be repunched. 

d. Special Codes - In addition to the Hollerith character set, 

the handler recognizes the ALT MODE terminator 
which is necessary for some system programs. 

ALT MODE, recognized as a 12-8-1 code (multiple- 
punched A8) is mapped into the standard ALT 
MODE character {175g) in the user's buffer. 

Each file must be terminated with an EOF card 
punched in either of two ways; a) multiple 
punch the characters +-0123456789 which punches 
all positions in card column 1, or b) multiple 
punch characters A0- which produces a 12-11-0-1 
punch in card column 1. 


NOTE 

The card reader handler used when the system is 
operated in Command Batching Mode (described in 
paragraph 8.12) is a separate handler similar to 
CDB, but resident in the Monitor itself. As in¬ 
itially supplied, it interprets cards punched in 
DEC 029 Hollerith Code. Another version, which 
recognizes DEC 026 Hollerith Code can be in¬ 
stalled into the system using procedures 
contained in the SGEN Manual. 


9.3.9 VP15A Storage Tube Display (VPA) 

VPA operates the VP15A Storage Tube Display. It accepts data in IOPS 
ASCII, Image Alphanumeric and Dump Modes. In IOPS ASCII and Image Al¬ 
phanumeric Modes, up to 70g (56po) 72-character lines can be displayed. 
In Dump Mode, the handler interprets each 18-bit word as a coordinate 
for point plotting operations. The binaries of VPA.S and VPA. are 
produced from the same source; VPA.xxx, where xxx is the current edit 
number. Two versions of VPA are provided. The version installed in 
the system as initially supplied (1260g locations) automatically era¬ 
ses the screen when an attempt is made to display the 57th ASCII line 
and that line is placed at the top of the screen. The other version 
of VPA, which has a file name VPA.S, is slightly larger (1266g loca¬ 
tions) . It permits the user to operate the display in a "paging" 
mode by setting console data switch 0 (when set to 1) to inhibit 
further output once the 56th ASCII line is displayed. Operation is 
resumed by pressing the ERASE pushbutton. Paging is stopped by re- 
setting console data switch 0 to 0 1 . 

1 Refer to the SGEN Manual for procedures for installing the VPA.S 
sion of VPA. 
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Table 9-17 lists the handler's response to the various I/O Macros. 
The user should refer to the VP15A Graphics Software Manual (DEC-15- 
UXSB—D). for a detailed description of the handler's capabilities and 
programming considerations. 

Table 9-17 


VP15A DISPLAY I/O FUNCTIONS 


Macro 

Response 

.IN IT 

Accept 

.FSTAT 

Ignore 

.RENAM 

Ignore 

.DLETE 

Ignore 

. RAND 

Illegal 

.RTRAN 

Illegal 

.SEEK 

; •' :■ " f . r "t :• •• 

Illegal 

.ENTER 

Ignore 

.CLEAR 

Ignore 

.CLOSE 

Accept 

.MTAPE 

Ignore 

. READ 

Illegal 

.WRITE 

Accept 

.WAIT 

Accept 

.WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (I0PS6 Error) 






9.3.10 UC15 XY11 PLOTTER (XYA) 


XYA (1145g locations) drives a Calcomp Plotter interfaced onto the 
PDP-11 in UNICHANNEL-15 systems. The legal data modes are IOPS ASCII 
and IOPS BINARY. 

IOPS ASCII is purely for character plotting. The characters have the 
size and orientation specified by the last "set character attribute" 
call (mode=10). The default setting calls for characters to be drawn 
each in 1/5" square box, in a horizontal direction. The box includes 
the intercharacter spacing, so that adjacent boxes touch. Horizontal 
is the length of the plotter paper roll, with the feed roll the di¬ 
rection of positive X. The ASCII characters of value 40-137 octal 
are plotted. Those below 40 (blank) are replaced by blank; those 
140-177 are mapped back to 100-137. Thus, a lower case "a" is plot¬ 
ted as an upper case "A". Note that this means that carriage return, 
line feed, etc., have no meaning on the plotter. IOPS ASCII output 
can be obtained, for instance, from FORTRAN FORMAT statements. 

IOPS BINARY writes are used to output data and control information to 
the plotter. The format of integer data in the buffer is a mode 
variable followed by several optional variables. The variables are 
integer. Co-ordinate addresses are in plotter steps (1/100"). 

MODE FUNCTION ADDITIONAL VARIABLES 1 


0 

pick up the pen 

none 

1 

put down the pen 

none 

2 

pen up, move to absolute 




position 

IX, 

IY 

3 

pen down, move to abso¬ 




lute position 

IX, 

IY 

4 

pen up, move relative to 




present position 

IX, 

IY 

5 

pen down, move relative 




to present position 

IX, 

IY 

6 

draw characters from array 

ICNT 

, ARRAY 

7 

present pen position de¬ 




fined as co-ordinate 

IX, 

IY 

8 

move to absolute position 




(no pen change) 

IX, 

IY 

9 

move relative to present 




position (no pen change) 

IX, 

IY 

10 

set character 

IX, 

IY, ISIN 


where IX is the horizontal size of the box surrounding each character, 
in plotter steps, and IY is the vertical size. ISIN and ICOS are 


The mode and additional variables are simply the data referenced by 
a .WRITE MACRO, or a FORTRAN write operation. 



integers to describe rotation of the character string counter-clock- 
wise from the horizontal position. ISIN is the sin of the angle times 
65536 ^q, and ICOS is the cosine times 65536 ^q» 

Interface routines may easily be written in FORTRAN to emulate a 
given plotter package. A CALL with certain arguments places those 
arguments in a .WRITE to the plotter. Scaling of inches to plotter 
steps should also be done here, if necessary. 


UC15 CALCQMP PLOTTER I/O FUNCTIONS 


MACRO 

RESPONSE 

.INIT 

Accept 

.CLEAR 

Ignore 

.CLOSE 

Accept 

.DLETE 

Ignore 

.ENTER 

Ignore 

.FSTAT 

Ignore 

.MTAPE 

Illegal 

.RAND 

Ignore 

.READ 

Accept 

.RENAM 

Ignore 

.RTRAN 

Ignore . 

.SEEK 

Illegal 

.TRAN 

Illegal 

.WAIT 

Accept 

.WAITR 

Accept 

.WRITE 

Accept 


Illegal results in IOPS 6 error message. 


A .INIT (issued by FORTRAN) lifts the pen, sets the default character 
attributes, and sets present X, Y to '0,0*. .INIT returns buffer 
size of 42g. Currently a buffer size of 104 g (204 g characters) is 
accepted. Buffers larger than this are ignored with no error 
message. 

A .READ returns in IOPS BINARY seven words of handler status. (Note, 
in the case of spooling, this status may not yet have been obtained 
by the plotter itself.) 
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1) present X co-ordinate, in plotter steps 

2) present Y " ,r " " 

3) horizontal character size 

4) vertical " " 

5) ISIN for character rotation, format given above 

6) ICOS for " " " " « 

7) 0 if pen up, 32768 1Q if down. 

For instance, from FORTRAN; 

READ (7) LASTX, LASTY, ISX, ISY, ISIN, ICOS, IPEN 
MACRO users note that the first returned word is an octal 
400000 for FORTRAN. 

.CLOSE forces the handler to send to the PDP-11 any writes held in 
the handler. Normally, 10 decimal writes are grouped together to 
make up one buffer which is sent to the PDP-11. 

A FORTRAN STOP statement will force a .CLOSE automatically. 

NOTES: 


It is possible to direct plotter output to a file on the disk, for 
instance. This file can then later be PIP—ed in IOPS binary mode to 
the plotter 0 Plotter output must be in the IOPS binary mode only. 

The offline switch for the plotter is switch #2 of the PDP-11 console 
switches, regardless of whether spooling is enabled or not. The 
plotter will stop when the switch is raised, and resume when lowered. 
An IOPSUC XYU 4 message (indicating offline) at the console is for 
information only, it is neither necessary nor possible to resume 
plotter operation by typing CTRL R. 
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CHAPTER 10 
OPERATING PROCEDURES 

10.1 INTRODUCTION 

This chapter provides general operating procedures and considerations 
to assist novice users in operating in the DOS-15 Monitor environment 
Procedures for system startup and system generation are the subject 
of Chapter 7 and are not included here. The discussions and examples 
in this chapter assume a properly configured and running system. It 
is assumed that the reader is familiar with the keyboard commands, as 
defined in Chapter 8. Further, the user should be aware of the dif¬ 
ferent types of I/O device handlers and their versions, as described 
in Chapter 9, and in particular, the tables which list those handlers 
which can be used with the DOS-15 System programs. 

Specific operating procedures for the system programs (i.e., command 
strings, options, functions, error messages, and so on) are provided 
in the various language and utility program manuals listed in the 
Preface. Once a user gains some understanding of the use of the sys¬ 
tem programs and their commands from these manuals, he will find that 
the DOS-15 Keyboard Command Guide (DEC-15-ODKCA-A-D) provides most of 
the information normally required for day-to-day user reference. 

Since most procedures involved with keyboard operation are specific 
to particular programs, very little will be said here about them. 

4 

In general, keyboard operations at the Monitor level consist of 
issuing commands to set up system operation, prior to calling system 
and user programs. This usually involves at least the LOGIN and 
LOGOUT commands, and quite often requires the PIP program, as well. 

This chapter consists primarily of two large examples of what might 
be typical DOS-15 operations. Each example is the result of an 
actual session at the PDP-15. On the left side of each page of the 
examples is the actual teleprinter output. All commands typed by 
the user are underlined. On the right is a running commentary on 
all significant teleprinter lines. 

10 . 2 EXAMPLE OF KEYBOARD OPERATIONS , ,, 

Figure 10-1, Example of DOS-15 Keyboard Operating Procedures, demon¬ 
strates some typical keyboard procedures. The example consists of 
a series of operations in which a simple FORTRAN program is trans- 



ferred to the disk from DECtape, edited, compiled, run, and trans¬ 
ferred back to DECtape. Figure 10-2, Listing of Sample FORTRAN Pro¬ 
gram, shows the program. The program simply prints the numbers 1 
through 10 on the device associated with .DAT slot 4, and then returns 
control to the Monitor. Figure 10-3 shows the teleprinter output, 
without comment. 


The user types CTRL C to prepare 
the Monitor for keyboard command 
input. If no response, the Monitor 
must be reinitialized using the 
bootstrap -- see Chapter 7. 


DOS-15 V3A 

ENTER DATE (MM/DD/YY) 


If the Monitor requests a date (in- 
11/2/7 Ij dicating it has just been started 
via the bootstrap) enter it as re¬ 
quired. Otherwise check the date 
(type D^) ) to make sure it is cur¬ 
rent and correct it if it is not. 


$L0GIN JOEj 


If the user wishes to use disk 
storage, he must log-in to the 
Monitor with a UIC of his creation. 


At this point, the user might con¬ 
sider typing other commands such 
as: VT ON, KEEP ON, X4K ON, PROTECT 
'etc. (refer to Chapter 8) . 


DOSPIP V7A 

> L tivdkJ 

02-NOV-71 
DIRECTORY LISTING 


(JOE) 


1660 

FREE 

BLKS 


11 

USER 

FILES 


1 5 7 

USER 

BLKS 


DKECH0 

001 

6 

tu -NOV"? 1 

T 

001 

3 

01 "NOV-71 

T 

002 

1 

01-NOV-71 

LEF 

SRC 

106 

01 -NOV-71 

JOB 

BIN 

15 

01 "N0V-7 1 

AL 

SRC 

1 1 

01-NOV-71 

AL 

BIN 

3 

01 -NOV-71 

MAX 

045 

3 

01 -NOV-71 

ACCT 

654 

3 

01 -NOV-71 


>T DK «-DT FTNTST SRCJ 


Call PIP 


Request a User File Directory 
listing to see if there is enough 
space available for the operations 
to be performed. (Since there 
are 1660 blocks indicated, the 
user can continue. If enough 
space were not available, however, 
other files in the UFD would have 
to be deleted.) 


If the user had no previous UFD 
on the disk, he would create one 
using the PIP command 

Hi 

Transfer program (FTNTST SRC) 
from user's DECtape to disk. 


Figure 10-1 

Example of DOS-15 Keyboard Operating Procedures 
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Return to the Monitor 


DOS-15 V3A 
$R EDI Tj 


Examine the .DAT/.UFDT slots 
for the EDITOR for proper 


DAT 

DEVICE 

UIC 

USE 

assignment (no 

15 

DKA 

JOE 

output/scratch 

in this case). 

14 

DK A 

JOE 

I/O 


10 

TTA 

JOE 

SECONDARY INPUT 



$EDIT J 


Call the EDITOR to correct any known 
errors on the file program prior to 
assembly or compilation. (In this 
case the FORTRAN comment line 
descriptor "C" was missing and must 
be inserted,,) 


EDITOR VISA 
> 0PEN FTNTSTV 
EDIT 

>P AJ 

C 

EXAMPLE 

C 


Open the file for editing. 

Locate error (i.e., print some lines) 

SAMPLE FORTRAN TEST PROGRAM Error line (the com¬ 
ment descriptor "C" 
is missing) 


> 1 J 

> N ?J 

J 

.EXAMPLE 
> C //C/ J 
c EXAMPLE 

> CL0SEV 

EDITOR VISA 
> f C 

DOS-15 V3A 


Go back to the top of the file. 
Point to the error line. 


Print it out as added precaution 
SAMPLE FORTRAN TEST PROGRAM 

Add the "C" to the 

SAMPLE FORTRAN TEST PROGRAM beginning. 

Close the file 


Return to the Monitor 


$R FAJ 


DAT 

DEVICE 

UIC 

USE 

1 3 

DKA 

JOE 

OUTPUT 

12 

LPA 

JOE 

LISTING 

>1 1 

DKA 

JOE 

INPUT 


Examine the .DAT/UFDT slots for the 
FORTRAN compiler for proper assign¬ 
ment. (In this case the user wishes 
to have his listing on the tele¬ 
printer, rather than the line 
printer.) 


$ A TT -1 Assign the teleprinter to .DAT-12 

Figure 10-1 (Cont.) 

Example of DOS-15 Keyboard Operating Procedures 



$faJ 


Call FORTRAN Compiler. 

F4X V44A Issue command string. 

>L 9 P<-FTNTSTj 


END 

PASS 1 


001 

C 


002 

C 

EXAMPLE - SAMPLE 

003 

C 


004 


DO 1 1=1,10 

005 

1 

WRITE (4,100)1 

006 

100 

FORMAT (6X,I3) 

007 


STOP 12345 

008 


END 

F4X 

>tC 

V44A 


DOS- 

15 V3A 



$r userJ 


ffl DAT 

DEVICE 

UIC 

tl 

DKA 

JOE 

+2 

DKA 

JOE 

+3 

DKA 

JOE 

r +4 

LPA 

JOE 

+ 5 

PRA 

J tP 


$ A TT A j 

$ GL0AD J 

BLOADER V12A 
= ^-FTNTST (a) 

1 

2 

3 

A 

5 

6 

7 

8 
9 

10 

STOP 012345 


DOS-1 5 V3A 
SPIPj 

DOSPIP V7A 

> T DT 1*-DK FTNTST SRC ^ 
I0PS4 TR 


Program listing output begins. 
FORTRAN TEST PROGRAM 


Compilation complete. 
Return to the Monitor. 


Examine the .DAT/.UFDT slots for 
available user programs. (This 
program uses .DAT slot 4 as refer 
enced in the FORTRAN WRITE state¬ 
ment in the listing above.) 


CTRL P typed to abort remainder of 
typeout. 


Assign the teleprinter to .DAT 
slot 4. 

Call the Linking Loader (load and 
go command. 

Give command string. 

The Symbol (a) represents Alt Mode. 

Program is loaded and execution 
begins. 


End of program execution. The 
Monitor is called automatically by 
the FORTRAN STOP statement. 

Call PIP. 


Transfer the edited source file 
from disk to DECtape. 

Device Not Ready error - the user 
forgot to WRITE ENABLE the DECtape 
unit. Once ENABLEd, he typed CTRL R 


Figure 10-1 (Cont.) 
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DOS-15 V3A 

ENTER DATE (MM/DD/YY) - 11/2/71 

$login joe 
$p IP 

DOSPIP V7A 
>L TT«-DK 

02-MOV-71 


DIRECTORY LISTING (JOE) 


1660 

FREE 

RLKS 


1 1 

USER 

files 


1 5 7 

USER 

BLKS 


DKECHO 

001 

6 

?j 1 -NOV-7 1 

T 

001 

3 

31-NOV-71 

T 

002 

1 

01 -NOV-71 

LEF 

SRC 

106 

01-NOV-71 

JOE 

BIN 

15 

01-NOV-71 

AL 

SRC 

11 

0 1-NOV-71 

AL 

PIN 

3 

U1-NOV-7 1 

MAX 

045 

3 

01-NOV-71 

ACCT 

654 

3 

>1-NOV-71 


>T DK «-DT FTNTST SRC 

>tC 


DOS-15 V3A 
$R EDIT 


*DAT 

DEVICE 

UIC 

USE 

-15 

DK A 

JOE 

OUTPUT/SCRATCH 

-14 

DKA 

JOE 

I/O 

-10 

$ED IT 

TTA 

JOE 

SECONDARY INPUT 


EDITOR VISA 
>OPEN FTNTST 
EDIT 
>P 4 
C 

EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 
C 


Figure 10-3 

Uncommented Listing of Keyboard Operating Session 
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>T 

>M 2 
>P 

EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

>C //C/ 

C EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

>CLOSE 

EDITOR V18A 
>tC 


DOS-15 V3A 
$R F4 


.DAT 

DEVICE 

UIC 

USE 

-13 

DKA 

JOE 

OUTPUT 

”12 

LPA 

JOE 

LISTING 

”11 

DKA 

JOE 

INPUT 


$A TT ~ 1 2 


$F4 

F4X V44A 
>L,B«-FTNTST 


END PASS 1 
001 C 

002 C 

003 C 

004 

005 1 

006 100 

007 
008 

F4X V44A 
>tC 


EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

DO 1 1=1,10 
WRITE (4,100)1 
FORMAT (6X,I3) 

STOP 12345 
END 


DOS”15 V3A 
$R USER 


«DAT 

DEVICE 

UIC 

+ 1 

DKA 

JOE 

+2 

DKA 

JOE 

+3 

DKA 

JOE 

+ 4 

LPA 

JOE 

+ 5 

PRA 

J tP 

$A TT 

4 



SGLOAD 


Figure 10-3 (Cont.) 

Uncommented Listing of Keybosrd Operating Session 
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RLOADER V12A 
><-FTMTST 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

STOP 012345 


DOS-15 V3A 
$PIP 


DOSPIP V7A 



Figure 10-3 (Cont.) 

Uncommented Listing of Keyboard Operating Session 


10.3 EXAMPLE OF OPERATING PROCEDURES USING COMMAND BATCHING MODE 


The example which is contained in Figure 10—4 demonstrates typical 
operations using the Monitor's Command Batching Facility. Figure 
10-5 contains just the console teleprinter output without comment. 
Essentially the same types of operations which can be performed at 
the keyboard can be accomplished using Command Batching Mode. There 
are, of course, some operations which, although legal, are more dif- 
ficult to accomplish, such as editing. To prepare a job for Command 
Batching Mode, the Programmer creates a file of keyboard commands 
in the sequence in which they would normally be issued from the tele¬ 


printer, interspersed with the special batching commands described in 
paragraph 8-12 (as applicable). The file can exist either on punched 
cards 1 or paper tape. The programmer then submits the batch file and 
other required data (DECtapes, Magtapes, etc. for use during the job 
run) to the computer operator for execution along with appropriate 
instructions. Users who prepare batching files on punched cards 
should remember to place an end-of-file card at the end of the card 
deck. This card is created by multiple punching all punch positions 
in card column 1 (see 9.3.8.1 d). 


The example below is basically similar to that in 10.2 except that 
no editing is performed since it is more easily and accurately ac¬ 
complished by the programmer directly. Similarly, requests for de¬ 
vice assignments were also omitted since this information cannot be 
utilized at runtime in a batching environment. 



i 

Only the CR03B card reader can be used. 
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$tc 



The operator types CTRL C to pre¬ 
pare the Monitor for keyboard com¬ 
mand input. 

$PATCH 



Instruct the Monitor to enter Com¬ 
mand Batching Mode with the paper 
tape reader as the batching input 
device (the batch tape has already 
been loaded in the reader). 

DOS”15 V3A 



The Monitor reinitializes itself 
indicating it has entered Command 
Batching Mode. 

SSJCB TEST COMMAND BATCHING MODE 

$JOB must be the first command on 




the batching medium. (The program¬ 
mer titles his batch run "TEST COM¬ 
MAND BATCHING MODE".) 

SLOGXN JOE J* 



Log-in the UIC to be used. 

SLOGj 

PLEASE MOUNT 

DECTAPE^ 

The programmer uses the LOG command 
to give instructions to the opera¬ 
tor . 

CONTAINING " 

FTNTST 

SRC" ON J 

DECTAPE UNTT 

1 AND 

SET J 

I TO WRITE ENABLEJ 


THANKS (3) 



/Ip signifies the Alt Mode character. | 

$$PAUSE J 

TR 



The $PAUSE stops the job to permit J 
the operator to comply with the 1 
instructions. The operator types j 
CTRL R to continue operation. j 

PIPJ 

DOSPIP V7A 



Call PIP. 

>T DK*-DT1 FT NT ST SRCJ 


Transfer the file to be compiled to 
the user's disk file area (it is 
assumed in this example that the I 

user has already created a UFD for 
himself at some previous time). 




>$jobJ 

DOS-15 V3A 



Return to the Monitor. 


Figure 10-4 

Example of Command Batching Mode 
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$ £ TT -12 ^ 


$F4 ) 

F4X V44A 
> L ,P ,<-FTNTST J 

END PASS 1 
001 C 

002 C 

003 C 

004 

005 1 

00S 100 

007 
008 

F4X V44A 


> $jon J 

DOS-15 V3A 
S A TT A j 


s glcad J 

BLOADER VI2A 
> <-FTNTST V 

1 

2 

3 

4 

5 
<5 

7 

8 
9 

10 

STOP 012345 

DOS-15 V3A 
$$JORj 


Assign teleprinter to .DAT slot -12 
(user should know standard assign¬ 
ments for his system) to permit 
FORTRAN listing to be output to it. 

Call the FORTRAN Compiler. 

Issue command string. 

Program listing output begins. 

EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

DO 1 1=1,10 
WRITE (4,100)1 
FORMAT (6X,I3) 

STOP 12345 
END 

Compilation ends. 

Return to the Monitor. 


Assign the teleprinter to .DAT slot 
4 (the user wants his program to use 
the teleprinter rather than the de¬ 
vice normally assigned to .DAT 4). 
Call the Linking Loader (load and 
go command). 

Issue command string. 

Program is loaded and execution 
begins. 


DOSPIP V7A 

>T DT1 «-DK FTNTST BIN^ 


End of program execution. The 
Monitor is called automatically by 
the FORTRAN STOP statement. 


Call PIP. 


Transfer the binary of the program 
just compiled to the user's DEC- 
tape for permanent storage. 


Figure 10-4 (Cont.) 
Example of Command Batching Mode 
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Delete the source file from the UFD. 

Request directory listing of user's 
disk area. 


Request directory listing of 
DECtape the user supplied with 
batch job. 


Batching run completed. Exit from 
Command Batching Mode. 


Figure 10-4 (Cont.) 

Example of Command Batching Mode 


BATCH PR 
DOF-15 V3A 

SS.JOB TEST COMMAND BATCHING MODE 
SLOG IN JOE 

SLOG 

PLEASE MOUNT DECTAPE 
CONTAINING "FTNTST SRC" ON 
DECTAPE UNIT 1 AND SET 
TO WRITE ENABLE 
THANKS 
S SPA USE 
tP 

SF IP 

DOSPIP V7A 

>T DK*-DT1 FTNTST SRC 

>S t !0B 

DOS-15 V3A 
SA TT -12 


Figure 10-5 

Uncommented Listing of Command Batching Mode 


> D DK FTNTST SRC ^ 


> L TT4-DK 3 

02-NOV-71 

DIRECTORY LISTING (JOE) 


163 6 

FREE 

BLKS 


13 

USER 

files 


161 

USER 

BLKS 


DKECHO 

001 

6 

01-MOV-71 

T 

001 

3 

3! -MOV- 71 

T 

002 

1 

01 -MOV- 71 

LEE 

SRC 

106 

31 -MOV- 71 

JOB 

RI N 

1 5 

0I-MOV-71 

AL. 

SRC 

1 1 

01-MOV-7 1 

Al. 

B J N 

3 

01 -MOV- 71 

FAX 

0 45 

3 

01-MOV-71 

AC C l 

654 

3 

01-MOV-7 I 

FI NTS 1 
FTNTST 

o C 

BIN 

1 

1 

02-MOV-7 1 
02 -MOV-71 

>L TT«-DT1 ) 


02-NOV-71 


DIRECTORY LISTING 


1066 

FREE 

BLKS 


2 

USER 

FILES 


10 

SYSTEM BLKS 


FTNTST 

SRC 

1 

1 

FTNTST 

BIN 

2 

1 

»$J0B.) 
DOS-15 

V3A 



SL0G0UT* 

$SEXIT* 



DOS-15 

V3A 




$ 
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$F4 * 

F4X V44A 

>l,b,«-ftntst 












END PASS 1 
001 C 

002 C 

003 C 

004 

005 1 

006 100 

007 
00S 

F4X V44A 
>$JOR 

DOS-15 V3A 
$A TT 4 


EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

DO 1 1=1,10 
WRITE (4,100)1 
FORMAT CSX,13) 

STOP 12345 
END 



SGL.OAD 

BLOADEF VISA 
>«-FTNTST 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

STOP 012345 

DOS-15 V3A 
$$JOR - 
PIP 

DOSPIP V7A 
>T DT1 «-DK FTNTST BIN 
>D DK FTNTST SRC 
>L TT«-DK 


02-NOV-71 

DIRECTORY LISTING (JOE) 


1656 

FREE 

BLKS 


13 

USER 

FILES 


161 

USER 

BLKS 


DKECHO 

001 

6 

01 -NOV-71 

T 

001 

3 

01 - NOV-71 

T 

002 

1 

01 -NOV-71 

LEF 

SPC 

106 

01-NOV-71 

JOB 

BIN 

15 

01 -NOV-71 

AL 

SPC 

1 1 

01 -NOV-71 

AL 

BIN 

3 

01 -NOV-7 1 

MAX 

045 

3 

01 - NOV-71 

ACCT 

654 

3 

01 - NOV-71 

FT NTS I 

SEC 

1 

32-NOV-71 

FTNTST 

BIN 

1 

0 2 - N 0 V - 7 1 


Figure 10-5 (Cont.) 

Uncommented Listing of Command Batching Mode 
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>L TTf-DTl 


02-NOV-71 
DIRECTORY LISTING 
10 66 FREE BLKS 
3 USER FILES 
10 SYSTEM RLKS 

FTNTST SRC 1 ! 

FTNTST BIN 2 1 


>£ JOB 

LOS-1 5 V3A 
SLOGOU 1 

$$EXIT 

DOS”15 V3A 
$ 


Figure 10-5 (Cont.) 

Uncommented Listing of Command Batching Mode 


10.4 ERROR DETECTION AND RECOVERY PROCEDURES 


All major components of the DOS-15 Software System contain facilities 
for error detection and operator notification. This includes the 
System Programs, I/O Device Handling Routines and the Monitor itself. 
The operator is notified of the existence of an error condition most 
generally by a message output to the console teleprinter. There are, 
however, two situations in which the operator would not receive a 
message on the teleprinter. The first is the normal occurrence of 
end-of-file, end-of-medium, parity and checksum error conditions by 
means of the information fields provided in header word 0 of the 
affected logical record a Recovery from these errors is not discussed 
here, since it is the user’s program which must recognize these 
conditions and determine the appropriate corrective action. (Refer 
to paragraph 6.3.1.1.) The second situation is the occurrence 
of an undetectable error such as a user's program looping endlessly. 
Under these conditions, the user can only detect the error condition 
by observing that the program is not operating as expected. His only 
recourse in this case is to abort the operation by typing CTRL C or 
CTRL Q. 



There are two types of error messages output to the console teleprint¬ 
er : 

® I/O errors which are detected by the I/O device handlers 

and printed through the Monitor's error message facility. 
These messages, referred to as "IOPS errors", consist of 
the mnemonic "IOPS" followed by a number. 

® System Program and Monitor detected errors which generally 

result from syntactically incorrect or illogical command 
strings or other illegal operating conditions. These 
messages are generally self-explanatory and consist of an 
appropriate symbol, word, phrase or sentence. 


The degree to which IOPS error recovery is possible can vary with 
the nature of the error. In some situations, it may be possible to 
continue the operation from the point where it was interrupted by 
the error message. For example, the I0PS4 message (I/O Device Not 
Ready) occurs when an I/O device hardware not ready condition is 
detected by the handler. To recover, all that is required is that 
the operator correct the condition (e.g., card reader out of cards) 
and type CTRL R. In a UC15 system this is required only for the 
RK05 disk cartridge. The operation will continue as if the error 
has never occurred. In other situations the operator may have to 
retype a command string correctly, restart the interrupted program 
(CTRL P) or call in the Monitor (CTRL C) to assign or reassign an I/O 
device or to reload the program. Some users may wish to save an image 
of core at the time of the error. In that case, the QDUMP command 
(see 8.7.2) would be typed before reloading the offending program. 

If, after typing CTRL C, the Monitor does not start up because a run- 
away program has destroyed the bootstrap, the bootstrap must be re¬ 
initialized or reloaded using procedures described in Chapter 7. 

Complete identification, explanation and recovery information for 
IOPS errors is provided in Appendix D. Similar information for 
other error messages is found in the applicable language or utility 
program manual for the applicable System Program. The DOS-15 Key - . 
board Command Guide , DEC-15-0DKCA-A-D, provides complete command sum¬ 
maries of all DOS-15 System Program and IOPS error messages. 






APPENDIX A 


PDP-15 IOPS ASCII STANDARD CHARACTER SET 

The table below shows the 7-bit ASCII characters intepreted by the 
DOS-15 Monitor and System Programs either as meaningful data and com¬ 
mand input or as control characters. The 7-bit octal code and the 
corresponding graphic characters conform to the standard ASCII 1968 
64-character graphic subset. 

The control characters (codes 00-37, and 175-177) are used for system 
control purposes. The characters shown in brackets [] are not used 
by the system and are available for user applications. Characters in 
parentheses denote the 1963 character set. 



A—1 








APPENDIX B 


SAMPLE TOPS ASCII PACKING AND UNPACKING ROUTINES 

This appendix contains two subroutines for use in packing and unpack 
ing IOPS (5/7) ASCII. These routines are self-contained and can be 
incorporated in user programs directly or contained in the DOS-15 
System Library (.LIBR BIN) or user-created library and referenced 
globally (.GLOBL pseudo-op). If they are to be incorporated direct¬ 
ly into a program, the .GLOBL and .END pseudo-ops must be removed. 

Unpacking Routine 

This routine has two entry points, GT.FST AND GT.CHR. The GT.FST 
entry is used to initialize the routine for each unpacking sequence. 
Upon entry via GT.FST, the AC must contain the address of the first 
location in the buffer. (The routine automatically skips over the 
Header Word Pair.) On return the AC is unchanged. After initiali¬ 
zation, each entry via GT.CHR returns a 7-bit ASCII character right 
justified in the AC. The user program must detect the end of the 
logical record, normally by checking for a Carriage RETURN or 
ALT MODE terminator. Entry to the routine from the user program is 
made by either a JMS or a JMS* instruction as follows: 

If this routine is directly incorporated in the user’s 
program: 

LAC ADDRESS /BUFFER ADDRESS 

JMS GT.FST /ENTRY TO INITIALIZE UNPACKING 

JMS GT.CHR /ENTRY TO UNPACK A CHARACTER 

If this routine resides in a library: 

.GLOBL GT.FST,GT.CHR/EXTERNAL GLOBL DECLARATION 


LAC ADDRESS /BUFFER ADDRESS 

JMS* GT.FST /ENTRY TO INITIALIZE UNPACKING 

JMS* 


DAC 


GT.CHR 

SAVCHR 


/ENTRY TO UNPACK A CHARACTER 
/SAVE CHARACTER RETURNED IN AC 



Packing Routine 


This routine also has two entry points, PK.FST and PK.CHR. The 
PK.FST entry is used to initialize the routine for each new packing 
sequence. Upon entry via PK.FST, the AC must contain the address of 
the first location in the buffer (the routine ignores the header word 
pair automatically); on return, the AC is unchanged. After initializa- 
tion, each entry via PK.CHR with a character in the AC will pack that 
character in 5/7 format. The characters to be packed must be right 
justified in the AC. On return to the user, the AC will still con¬ 
tain that character, however, bits 0-10 of the AC will be set to zero. 
The user program must detect the end of the logical record, normally 
by testing for a terminator such as Carriage RETURN or ALT MODE. 
Further, the user must also set up the header word pair for the 
logical record. Entry to the packing routine is made from the user's 
program either by a JMS or JMS* instruction as follows: 


If this routine is directly incorporated in the user's 
program: 


LAC ADDRESS 
JMS PK.FST 


/BUFFER ADDRESS 

/ENTRY TO INITIALIZE PACKING 


LAC CHAR 
JMS PK.CHR 


/CHARACTER TO BE PACKED 
/ENTRY TO PACK A CHARACTER 


If this routine resides in a library: 

.GLOBL PK.FST, PK.CHR /EXTERNAL GLOBL DEFINITION 


LAC ADDRESS /BUFFER ADDRESS 

JMS* PK.FST /ENTRY TO INITIALIZE PACKING 


LAC CHAR /CHARACTER TO BE PACKED 

JMS* PK.CHR /ENTRY TO PACK A CHARACTER 










/I OPS AS^II "NPACK I M (4 SUBROUTINE 
/ ' '• % 

/GT , F’ST - IMM i A|_ I *e 5/7 .ASCII UNPACKING, QN ENTRY 
/AC Cfif-TAlMS A013R E S S OF I/O BUFFER TO BE 
/UNPACKED. r»E RE tub ■ AC IS RESTORED, 

/GT , AFTER b/7 .ASCII UNPACKING HAS BEEN 


MOITIAU^FO F-Y GT.FST, GTiChR 
/SUBSFGUrM CHARACTERS IS AC, 

/ * 



. sin p l, 

S T , F S T 

G T , F G T 




n AC 

GT , TMR 


TAP 

L 2 


D A C 

G T , P T R 


1. AN 

-1 


n A C 

ST.b 


L A C 

GT , T>P 


JMP# 

ST.F'ST 

NT , CUR 

'i 



IS? 

G T , 5 


JMP 

ST ,M0 


lac* 

GT.PTR 


I s? 

G T , P T R 


SAC 

GT , WD1 


1 AC# 

G T , p T R 


ISZ 

s r , p T R 


SAC 

ST,WD2 


L A W 

17 773 


0 A C 

ST ,5 

RT , Mf 

L A W • 

17 7 7C 


0 AC 

GT , W D3 

ST , LUP 

lac 

ST , W02 


R AL 



TS? 

G T , W D 3 


JMP 

GT , MOR 


AND 

LI 7 7 


SAD 

space 


JMP 

GT,EXT 

G T .EXT 

J M P # 

GT, CHR 

ST,MOR 

DAC 

GT, W02 


lac 

6. T , K D1 


ral 



0 A C 

G T , W01 


JMP 

GT.UiP 

/ 



S T , P T R 

c 


ST, 5 

n 


ST,HOI 

* 


ST, WO? 

;* 


ST,WD3 

rr, 


ST,TMP 



12 

2 


U77 

17 7 


SPACE 

AO 



. F NQ 



WILL RETURN 


/INITIALIZE 
/SAVE AC 

/SET BUFFER POINTER 

/TO SKIP OVER HEADER WORD PAIR 

/CHARACTER COUNTER 

/RESTORE AC 


/word pair start r d 
/need NEXT Pair 

/PIRST PART 


/SECOND PART 

/RESET CHARACTER COUNTER, 
/SHIFT LOOP TO 7 i/2 TIMES 


/GOT CHARACTER 

/IP SPACE DOM UPDATE GT , L$ T 
/EXIT 


/BACK TO LOOP 



B-3 





/I OPS ( 5 / 7 ) /.SCI I PACKING SUBROUTINE 
/ 

/PK,r$T -INITIALIZE 5/7 ,ASCI I UNPACKING, ON EKTcY 

/AC CONTAINS ADDRESS OF I/O BUFFER TO CONTAIN PACKED ASCI I , 

/ON RETURN Ar IS UNCHANGED« 

/PK,CHR IS MQRMAL ENTRY POINT AFTER INITIALIZATION (PK.FST), 
/AC CONTAINS CHARACTER TO BE PACKED, ON RETURN, aC CONTAINS 
/The SAME CHARACTER BUT HIGH ORDER BITS (0-10) ARE ZEROED 
/OUT . 

/ 



. GLOP 

l. P K , f S T 

, PK,CHR 



S H A L 6 ( 






P K , F S T 

D AC 

me-HR? 


/initialize 

/SAVE AC 



tad 

1.2 


/SET KLPUTP TO 3iiFFE» 

address 


D AC 

K L P U T P 


/TO SKIP OVER HEADER 

WORD PAIR 


D/M 

K L 3 7 





D ZM 

ohrcnt 





LAC 

KLCHR2 


/RESTORE AC 



J M P -if 

PK , FST 


/EXIT 


R K , C M R 

(7* 

IS/ 

AND 

CHRCUT 
Li 7 7 





n A C 

K L C H R 2 





CLL 






LAC 

* L 37 


/char position, 



TAD 

(JMPa l 

KLJ57 




D A C 

.+2 





LAC 

K L C H K 2 





XX 



/modified JMP 


*L J3 7 

K L 3 71 



/CHARI 



KL.57? 



/ C H A R 2 



K L 3 7 3 



/ C H A R 3 



KL374 



/CHAR4 



KL37^ 



/CHAR3 


/ L 3 71 

ALS!SHAL 

13 

/u left 


*1571A 

0 7 M « 

klputp 


/CLEAR DATA WORD 



JMP 

KLND57 




KL37? 

ALS ! SHAL 

4 

/4 LEFT 



JMP 

K l N D 3 7 




m37 < 

RTR 



/3 RIGHT-1ST HALF 



RAR 






and 

L17 





XQRtt 

KLPUTP 





n a c 

K L P U T P 





is/ 

K L p U T P 


/LAST WORD OF F A f R, 



L AC 

K L C h F< 2 


/ 2ND HALF 



A L s ! S H A L 

17 

/ 15 LEFT 



JMP 

K L 3 71A 




*1-3 7 4 

ALS! SI 

HAL 

10 

/a left 



jMP 

KLND57 




k L 3 7 3 

RCL 



/I LEFT 



dZm. 

KL37 


/reset 3/7 counter 



S K P 





KIND 57 

IS? 

KL 37 





XOR* 

KLPUTP 





0 AC* 

KLPUTP 









i ■ 


B-4 




lac 

KL57 


SNA 



T S7 

KLPUTP 

/2ND WORD CONPLE.TE 

LAC 

KLCHP2 


j M P « 

PK,CHR 

/EXIT, 


V L 5 7 fli 
WL.PIJTP pi 
KLGHP2 C 
CHRCNT P 
I„ 2 ? 

L177 1/7 

1,17 1 7 

/ 

. E.MO 


B-5 
























Input/Output Data Mode Terminators for Specific Device Handlers (Cont. 





0 

0 

0 




0 


0 




t—1 

i — 1 

r—1 




i—i 


1 — 1 

Eh 



ft 

ft 

ft 




ft 


ft 

D 



0 

0 

0 




0 


0 

ft 



O 

o 

o 




o 


o 

Eh 



-H 

•H 





-H 
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APPENDIX E 


LINKING LOADER AND SYSTEM LOADER ERRORS 


The following error codes are output by both the Linking Loader and the 
System Loader. When output by the Linking Loader, the errors are 
identified as shown below. When output by the System Loader, the 
errors are identified as ".SYSLD n" instead of ".LOAD n". 


Error 


.LOAD 1 


.LOAD 2 


•load 3 


.LOAD 4 


.LOAD 5 


Memory overflow - the Loader's symbol table 
and the user's program have overlapped. At 
this point the Loader memory map will show 
the addresses of all programs loaded suc¬ 
cessfully before the overflow. Increased 
use of COMMON storage may allow the pro¬ 
gram to be loaded, as COMMON can overlay the 
Loader and its symbol table, since it is 
not loaded into until run time. 

Input data error - parity error, checksum 
error, illegal data code, or buffer over¬ 
flow (input line bigger than Loader's 
buffer). 

Unresolved Globals - any programs or sub¬ 
routines required but not found, whether 
called explicitly or implicitly, are 
indicated in the memory map with an ad¬ 
dress of 00000. If any of the entries in 
the memory map has a 00000 address, 
loading was not successful; the cause of 
trouble should be remedied and the pro¬ 
cedure repeated. 

Illegal .DAT slot request - the .DAT slot 
requested was: 

a. Out of range of legal .DAT slot 
numbers, 

b. Zero, 

c. Unassigned; that is, was not set 
up at System Generation Time or 

was not set up by an ASSIGN command. 

Program segment greater than 4K - the program 
segment being loaded in Page Mode exceeds a 
Page Bound (i.e., program is greater than 4K). 





APPENDIX F 


PDP-15 ASCII/HOLLERITH CORRESPONDENCE 


The following table shows the correspondence between the PDP-15 64 
character graphic subset of ASCII and the DEC 029/026 Hollerith codes. 
Both 029 and 026 codes are identical for numeric and alphabetic 
characters but vary for symbol representation. The 029 code, except 
as indicated by brackets [], is a subset of the standard Hollerith 
punched card code specified in ANSI standard X3«26—1970. Characters 


in parentheses denote the 1963 character set. 


| ASCII 

HOLLERITH 

ASCII 

EOLLE^T~~\ 


/-BIT 

DEC 029 

DEC 026 


7-BIT 

DEC 029 

DEC 026 

CHAR. 

CODE 

CODE 

CODE 

CHAR. 

CODE 

CODE 

CODE 

Space 

40 



@ 

100 

8-4 

8-4 

! 

41 

[11-8-2] 

12-8-7 

A 

101 

12-1 

12-1 


42 

8-7 

LO 

I 

CO 

1 

o 

B 

102 

12-2 

12-2 

# 

4 3 

8-3 

0-8-6 

C 

103 

12-3 

12-3| 

$ 

44 

11-8-3 

11-8-3 

D 

104 

12-4 

12 “ 4 | 

% 

45 

0-8-4 

0-8-7 

E 

10 5 

12-5 

12-5| 

& 

46 

12 

11-8-7 

F 

106 

12-6 

12-6 

f 

47 

8-5 

8-6 

G 

107 

12-7 

12-7 

( 

50 

12-8-5 

0-8-4 

H 

110 

12-8 

12-8 

) 

51 

11-8-5 

12-8-4 

I 

111 

12-9 

12 " 9 [ 


52 

11-8-4 

11-8-4 

J 

112 

11-1 

11-1 

+ 

53 

12-8-6 

12 

K 

113 

11-2 

11-2 


54 

0-8-3 

o 

1 

00 

1 

LJ 

L 

114 

11-3 

11-3 

“ 

55 

11 

11 

M 

115 

11-4 

11-4 

• 

5 6 

12-8-3 

12-8-3 

N 

116 

11-5 

11-5 

/ 

57 

0-1 

0-1 

0 

117 

11-6 

11-6 

0 

60 

0 

0 

P 

120 

11-7 

11-7 

1 

61 

1 

1 

Q 

121 

11-8 

11-8 

2 

G2 

2 

2 

R 

122 

11-9 

11-9 

3 

6 3 

3 

3 

S 

123 

0-2 

0-2 

4 

64 

4 

4 

T 

124 

0-3 

0-3 

5 

61) 

5 

5 

U 

125 

0-4 

0-4 

6 

6 6 

6 

6 

V 

126 

0-5 

0-5 

7 

67 

7 

7 

W 

127 

0-6 

0-6 

8 

70 

8 

8 

X 

130 

0-7 

0-7 

9 

71 

9 

9 

Y 

131 

0-8 

0-8 

: 

72 

8-2 

11-8-2 

Z 

132 

0-9 

0-9 


73 

11-8-6' 

0-8-2 

[ 

133 

12-8-2 

11-8-5 

< 

74 

12-8-4 

12-8-6 

\ 

134 

11-8-7 

8-7 


75 

8-6 

8-3 

] 

135 

0-8-2 

12-8-5 

> 

76 

0-8-6 

11-8-6 

~ (f) 

136 

12-8-7 

8-5 

? 

77 

0-8-7 

12-8-2 


137 

0-8-5 

8-2 

NOTES: 

1. ASCII codes 00 

-37 and 140-177 have no 

sorresi 

oonding c 

:odes in 


the DEC 026 & 

029 Hollerith sets and therefore, are not pre- 


sented here. 







2. ALT MODE is simulated by 

a 12-8-1 punch (multiple punch A8). 


3. End- 

of-file corresponds 

to a 12-11-0-1 

punch 

(multiple punch 


A0- } 

. 







4. The 

card reader hardware 

supplies the binary 

equivalent of 


Hollerith code 

which in 

turn is mapped 

into 

7-bit ASCII by 


the Card Reader Handler. 
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DOS-15 CHECKOUT PROCEDURES 

INTRODUCTION 

The purpose of the DOS-15 checkout package is to show that the system 
has been properly installed onto DECdisk r Disk Cartridge or Disk Pack 
It does so by briefly testing all the basic pieces of the DOS-15 
System Software. The following is a list of programs tested: 


1 . 

2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 
9. 

10 . 


11 . 


DOS-15 Resident and Nonresident Monitors 
PIP 

FORTRAN Compiler and Object Time System 
MACRO Assembler 

Linking Loader and System Loader 

Chain and Execute System Programs 

System Disk Device Handler 

Paper Tape Reader Handler 

Teleprinter Handler 

BATCH System Commands 

DOSSAV System SAVE/RESTORE program 


The batch paper tapes for the DOS-15 Checkout Package are identified 
as follows: 


RF.CHK (for the RF15 DECdisk System) 

RP.CHK (for the RP02 Disk Pack System) 

RK.CHK (for the RK05 Disk Cartridge System) 

CHECKOUT PACKAGE OPERATION 

Load the DOS-15 System as described in Chapter 10. Place the paper 
tape labeled "RF.CHK" (if DECdisk System) or "RK.CHK" (if Disk 
Cartridge system) or "RP.CHK" (if Disk Pack system) in the paper tape 
reader and type: 

$BATCH PRJ 

The commands contained on the tape will then run the checkout package 
to completion as indicated on the teleprinter before leaving Command 
Batching Mode. 



CHECKOUT PACKAGE RESULTS 


The result from the FORTRAN Object Time System (shortly after the 
GLOAD command) should be: 

-J2f. 123 5E+J03 


Also the result of the Chain and Execute programs should be: 


-jeI.1234E+05 
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DOS TERMS AND ACRONYMS 


Terms unique to the PDP-15 DOS Software System are listed and 
described in the following table. The acronyms for each term are 
also given. 


TERM 

ACRONYM 

DEFINITION j 

Bad Allocation Table 

BAT 

A device (disk) table which in- j 

dicates, in storage blocks, any j 

faulty disk areas in which data 
cannot be stored. 

Master File Directory 

MFD 

A master device (disk) file di- j 
rectory which contains pointers S 
to all user directories (UFD's) f 
within a disk device. j 

Monitor Identification Code 

MIC 

The master system password which 1 

permits full access to all files 
within the system. This code 
identifies the system manager 
and should be used only by him. \ 

Storage Allocation Table 

SAT 

The device (disk) table which 
stores busy, not-busy indicators 
the disk storage area. 

System Block 

SYSBLK 

The system table which contains 
the names, locations, and loading 
and starting parameters for all 
system programs within the oper¬ 
ating system. 

User File Directory 

UFD 

File directories for each user who 
established disk file storage 
areas within the system. 8 

User File Directory Table 

UFDT 

The system directory table which j 
maintains the relationship between 1 
the system's .DAT slots and each 1 
unique user identification code i 
(UIC) . | 

User Identification Code 

UIC 

A password entered by a user to 8 
uniquely define himself and any I 
files which he may enter. If 1 
necessary, a user may enter more 1 
than one UIC to establish several 1 
unique sets of files. Since only 8 
one user may employ the system at 1 
any one time, the current UIC is 1 
the last logged-in UIC. 1 
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UC15 SPOOLER ERROR MESSAGES 


The following is a list of the error messages printed by the 8 SPOOL 8 
program and the conditions that cause these: 


MESSAGE 


CONDITIONS 


BAD DIRECTIVE 


User typed an illegal 
commando 


NO BUFFERS IN SYSTEM?? The system does not have 

enough buffers to support 
the spooler« Use the 
DOS BUFFS command to 
increase the number of 
system buffers, 

SPOOLER NOT LOADED - COMMAND IGNORED An END command was issued 

with no spooler running, 

SYSTEM HAS NO UC15 An attempt to use spooling 

on a non-UCl5 system 
occurred. 


SPOOLll WILL NOT FIT IN 11-LM Free core available in 

the 11 local memory not 
sufficient for spooler 
program to fit, 

SPOOLER ALREADY RUNNING - COMMAND IGNORED An attempt to begin the 

spooler was made with 
the spooler already 
running, 

SYSTEM ERROR - RELOAD PIREX A fatal system error has 

occurred. Reload PIREX 
and rebegin the spooler. 
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UC15 SYSTEM ERROR MESSAGES 

The Error Messages from tasks running under PIREX have the following 
format. 

IOPSUC YYY XXXX 

Where YYY denotes one of the followings 


EST 

Stop all I/O 

task 

ESD 

Software Driver 

/■-it- r ; 

RKU 

Disk Cartridge ,i • 

II 

DTU 

DECtape 

11 

LPU 

Line Printer 

II 

CDU 

Card Reader 

II 

PLU 

Plotter 

It 

ESP 

Spooler 

II 

EMA 

MACH 

II 


XXXX denotes one of the following: 

3 - Illegal interrupt to driver 

4 - Device not ready- 

12 - Device failure 

15 - Spooler full warning message 

45 - Greater than 80 column card 

55 - No spooler buffers available 

72 - Illegal punch combination 

74 ~ Timing error-card column lost—-retry card 

75 - Hardware busy~-driver not 

76 - Hardware error between cards 

77 - Unrecognized task request—-device not present 
400 - Spooler empty~-PDP15 input request pending 


J-l 





Additional IOPS error messages: 


Error 

200 

300 

400 

500 

600 

777 


Code Meaning 


Nonexistent task referenced® 

Illegal API level given (illegal values 
are changed to level 3 and processed). 

Illegal directive code given. 

No free core in the PDP-11 local memory. 

ALT node for this TCN missing 

Request node was not available from the 
POOL; i.e,, the POOL was empty and the 
referenced task was currently busy or the 
task did not have an ATL node in the Active 
Task List. 
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INDEX 


..ABS and .ABSP Binary, 3-8 
Absolute binary code, 3-8 
Access to files, 4-4 
directoried, 3-6, 4-7 

non-directoried, 4-6 

random, 4-4 
random-sequential, 4-4 

sequential, 3-5, 4-5, 4-6, 6-3 
Allocating buffer space, 6-14, 
6-15, 6-16 

Alphanumeric data, 6-7 
ALT MODE, 6-9, 6-10, 8-2 

API (Automatic Priority Interrupt) 
3-4, 4-2 

API ON/OFF command, 8-19 
ASCII 

character packing (sixbit), 5-2 

§ "\ Hollerith correspondence, F—1 

packing and unpacking routines, 
standard character set, A-l 
Assembler, MACRO, 2-2, 2-3 
ASSIGN command, 4-1, 8-12, 8-28 
Automatic Priority Interrupt (API) 
3-4, 4-2, 8-19 


Bank mode operation, 3-9 
BANK ON/OFF command, 8-20 
BAT (Bad Allocation Table), H-l 
BATCH command, 8-26 
Batching commands, 8-25 to 8-28 
job control commands, 8-26 
operator commands, 8-26 
restrictions, 8-27 
Binary code, absolute, 3-8 
Binary, relocatable, 3-7, 3-8 
.BLOCK pseudo-op, 6-14 

Bootstrap program, 7-2, 7-8, 7-9 
restart, 7-9 
Bracket ([ ] ) usage, 5-2 
Buffer, I/O, 3-7 
header words,. 4-2 
overflow, 6-6, 6-13 
pool, 4-11 

size for logical records, 6-4 
size for VT display, 8-19 
space allocation, 6-14 to 6-16 
BUFFS command, 8-13 

Calendar date entry, 8-21 
CALCOMP plotter, 9-32 
Card files, 3-5 

Card Reader handler, 9-28 to 9-30 
Carriage return, 5-1, 6-9,6-10,8- 
CHAIN and EXECUTE programs, 2-8 
advantages, 2-9 
disadvantages, 2-9 
CHAIN .DAT slot assignments, 9-9 
CHANNEL 7/9 command, 8-20 


Characters, 

ASCII, A-l, F-l 
(nonprinting) for teleprinter 
functions, 9-12 

Checkout package, 1-13 
procedures, G~1 
Checksum, 6-5, 6-9 
.CLEAR macro, 6-17 
.CLOSE macro, 6-17, 6-31 
Command Batching Mode restric¬ 
tions, 8-27 

Command default settings VT 
Display, 8-19 
Command Batching Mode, 3-4 
Commands 

Batching keyboard, 8-25 to 8-28 
core allocation, 8-13, 8-14 
core image Save/Restore, 8-14 to 
B-l 8-17 

DOSSAV, 7-3, 7-4 

DOSSAV examples, 7-5, 7-6 
file protection, 8-8 
Input/output, 6-2 
I/O device assignments, 8-10 
keyboard, 3-3, 3-4, 8-1, 8-2 
miscellaneous, 8-19 
Monitor, 5-1 

program s tart/res tart/continue, 
8-23, 8-25 

to request system information, 
t 8-3 

VT15 Display, 8-17 to 8-19 
Communications, I/O, 6-1 
Compiler, FORTRAN IV, 2-1 
Console keyboard, 8-1 
Console teleprinter, 3-3 
Core allocation commands, 8-13, 
8-14 

Core image Save/Restore commands, 
8-14 to 8-17 

CTRL commands, 8-2, A-l 
CTRL C, 8-23, 8-26 
CTRL P, 8-23 
CTRL Q, 8-15 
CTRL R, 8-25, 8-26 
CTRL S, 8-25 
CTRL T, 8-25, 8-26 
CTRL U, 8-2 
CTRL X, 1-8, 8-19 


.DAT (Device Assignment Table) 

3-5, 4-1, 6-16, 8-8 
•DAT slot assignments, 9-3 to 9-30 
CHAIN, 9-9 
DTCOPY, 9-10 

DUMP, 9-8 

EDIT, EDITVP, EDITVT, 9-6 
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.DAT slot assignments (continued) 
EXECUTE, 9-9 
FOCAL, 9-5 

FORTRAN IV (F4), 9-3 

Linking Loader and DDT, 9-6 

MAC11, 9-4 

MACRO-15 

MTDUMP, 9-10 

PATCH, 9-8 

PIP, 9-7 

SGEN, 9-7 

SPOOL, 9-11 

SRCCOM, 9-9 

8TRAN, 9-10 

89TRAN, 9-10 

UPDATE, 9-8 

.DAT/.UFDT slot assignments, 8-13 
Data 

fields, 6-4 
storage, 6-10 
transfers, 6-1 
transfer program, 2-10 
Data modes, see Modes 
$DATA command, 8-27 
DATE command, 8-21 

DDT (Dynamic Debugging Technique)2-9 
DECdisk, Disk Cartridge and Disk 
Pack handlers, 9-19 to 9-24 
DECtape 

directories, 4-6 
file structure, 4-6 
handlers, 9-18 

DECtape COPY (DTCOPY) Program, 2-12 
Default device assignments, 4-1 
Default protection code, 3-7, 8-9 
Delimiters, keyboard commands, 8-2 
Device 

assignments, 4-1 
capabilities, 6-29 
independence, 3-4 
Device, 

directoried, 3-6 
file-oriented, 3-6 
system, 1-6 

Device Assignment Table (.DAT), 3-5, 
4-1, 6-16, 8-8 

Device dependent I/O.programming, 

6-33 

Device handler characteristics, 6-29 
Device handlers, 3-4, 3-5, 9-10 
also see Handlers, device 
Direct access, 3-5, 4-4 
Directoried data access, 4-7 
Directoried devices, 3-6 
Directoried mode, 4-6 
Disk 

data access, 4-7, 4-8 
file structure, 4-8, 4-11 
handlers, 4-11, 9-18 
Disk pack handlers, 9-18 to 9-22 
Disk restoration (DOSSAV), 7-2, 

example, 7-5 
tapes, 7-1 
Disk save, 7-6, 7-7 
Display mode, VT15, 8-17 


.DLETE macro, 6-18 
DOSSAV (disk restoration), 
commands, 7-3 
error conditions, 7-7 
restart procedures, 7-8 
DTCOPY (DECtape COPY program), 2-11 
.DAT slot assignments, 9-10 
DUMP .DAT slot assignments, 9-8 
Dump mode, 6-3, 6-6, 6-12, 6-14, 

6-3 3 

DUMP program, 2~io 
Dynamic Debugging Technique (DDT), 
2-10 


Editing features, keyboard com¬ 
mands, 8-2 

Editing programs, EDIT, EDITVP, 
EDITVT, 2-10 

.DAT slot assignments, 9-6 
$END command, 8-27 

End of file (EOF), 6-6, 8-22 

End of medium (EOM), 6-6 

.ENTER macro, 6-18, 6-33 
Errors, 10-5 
batching, 8-28 
DOSSAV, 7-7, 7-8 
IOPS, D-l 
Linking Loader, E-l 
SPOOLER, 1-1 
system, E-l 
UC15 System, J-l 
Example I/O programming, 6-33 
EXECUTE program, 2-7 

.DAT slot assignments, 9-9 
$EXIT command, 8-27 
.EXIT macro, 5-6 
External globals, 3-9 


Features of system, 1-2 
Fields, data, 6-4 
File 

directories, 3-6 
integrity, 6-44 
organization, disk, 4-11 
processing, sequential, 6-3 
protection 3-7, 4-9, 8-8 

File-oriented devices, 3-6 
Files 

definition of, 4-2 
direct access, 3-5 
sequential, 3-5 

Floating point processor software,7-1 
FOCAL .DAT slot assignments, 9-5 
FOCAL interpreter, 2-5 
Form control characters, 9-26 
FORTRAN IV (F4), 2-2 

Compiler, 2-1 
.DAT slot assignments, 9-5 
.FSTAT macro, 6-19 
.FULL and .FULLP pseudo-ops, 3-8 
Function characters (non-printing) 
for teleprinter, 9-12 
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GET command, 8-16, 8-17 
.GET macro, 5-4 
Global symbols, 2-3, 3-9 
external, 3-9 
internal, 3-9 
.GLOBL pseudo-op, 3-9 
GRAPHIC15 programs, 2-12 
.GTBUF macro, 5-5 
.GVBUF macro, 5-5 


HALF ON/OFF command, 8-19 
HALT command, 8-22 
Handler characteristics, 6-29 
Handlers, I/O device, 3-5,9-1 to 9-30 
Card Reader, 9-27 
DECdisk, 9-18 
DECtape, 9-17 
Disk pack, 9-18 
DOS-15 (summary), 9-1 

Line Printer, 9-25 


Magtape, 9-23 
Paper Tape Punch, 9-15 
Paper Tape Reader, 9-15 
Teleprinter, 9-11 
VP15 Storage Tube, 9-29 
Hardware 

errors, 7-8 

malfunction, 7-9 

minimum. 1-3 

optional, 1-5 

rT Unichannel 15, 1-7 

Hardware Readm Mode, 


6-4 


7-3 
. 6-12 


Header word pair, 
format, 6-5 
Hollerith/ASCII correspondence. 
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Image Alphanumeric Mode, 6-6, 6-10 
Image Binary Mode, 6-6, 6-10 
Image Mode, 6-3, 6-33 
Independence, device, 3-4 
Initializing 
handler, 6-29 
system, 7-1 

.INIT macro, 6-20, 6-29 
Input/Output (I/O) 
buffers, 3-7 
commands, 6-2 
communication, 3-4, 6-1 
control characters, A-l 
data mode terminators, C-l 
device assignment commands, 8-10 
to 8-13 

device handlers, see Handlers, 

I/O device 

device specification, 6-16 

errors, 10-5 

functions. Magtape, 9-24 

macro descriptions, 6-16 to 6-28 

macro syntax, 6-29 

macros, using, 6-29 

process, 4-1 

programming examples, 6-33 to 6-43 
spooling, 3-11 

transfer to directoried device,6-31 


Input/Output Programming System 
(IOPS), 3-2 

INSTRUCT command, 8-5 
Internal globals, 3-9 
Interpreter, FOCAL, 2-4 
.IODEV pseudo-op, 6-16 
IOPS (Input/Output Programming 
System),3-2 
ASCII mode, 6-6, 6-7 
Binary mode, 6-6, 6-7, 6-9 
error codes, D-l 
errors, 3-10 
mode, 6-3 


$JOB, batching mode job 
separator, 8-26 


KEEP ON/OFF command, 8-13 
Keyboard commands, 3-3, 3-4, 8-1 
8-2, 8-3 

editing features, 8-2 
Keyboard operations, 10-1 
example, 10-2, to 10-8 


Languages, 2-1 

FOCAL Interpreter, 2-4 
FORTRAN IV Compiler, 2-1 
MACRO Assembler, 2-2 
Library, science, 2-2 
Library subprograms, 2-8 
Library UPDATE program, 2-12 
Line Printer handler/ 9-26 to 9-28 
Line Printer on/off, 8-20 
Line terminators, 6-9 
Linking Loader, 2-1, 2-9, 8-25 
.DAT slot assignments, 9-6 
errors, 3-10, E-l 
Loader control, 3-8 
Loader, system, 3-1 
Loading commands, system program 
8-23, 8-24 
Loading 

Monitor, 7-8 
program, 3-9 
system, 7-1 
Logical record,, 6-4 
format, 6-3 

terminating condition, 6-4,C-l 
terminators, 6-12, 6-13 
LOG command, 8-22 
LOGIN, 3-6 
LOGIN command, 8-8 
LOGOUT command, 8-9 
LP ON/OFF command, 8-20 
MACH Assembler, 2-4 

.DAT slot assignment, 9-4 
Macro combinations, I/O, 6-30 
Macros, 2-3 

Macro sequence, I/O, 6-31 



Macros, I/O, 6-2, 6-16 to 6-28 
.CLEAR, 6-17 
* CLOSE, 6-17 

.DLETE, 6-18 

.ENTER, 6-18 
.FSTAT, 6-19 
.INIT, 6-20 
•MTAPE, 6-21 

.RAND, 6-21 
.READ, 6-22 
.RENAM, 6-23 
.RTRAN, 6-23 
.SEEK, 6-24 
.TRAN, 6-25 
.USER, 6-26 
.WAIT, 6-27 
.WAITR, 6-27 
.WRITE, 6-28 
Macros, system, 5-1, 5-7 
.EXIT, 5-6 
.GET, 5-4 
.GTBUF, 5-5 

.GVBUF, 5-5 

.OVRLA, 5-6 

.PUT, 5-3 
.TIMER, 5-7 

Magnetic tape (Magtape), 4-5 

handlers, 9-24 to 9-26 
Magnetic Tape Dump (MTDUMP) utility 
program, 2- 

MACRO Assembler, 2-2, 2-3 
MACRO-15 .DAT slot assignments, 9-4 
Mass storaqe, 4-3 
DATE command, 8-21 
devices, 6-4 

Master File Directory (MFD), 3-6, 
4-8, H—1 

Messages, see Errors 

MFD see Master File Directory 

MIC see Monitor Identification Code 

MiCLOG command, 8-9 

Miscellaneous commands, 8-19 

Modes 

Bank, 3-9, 8-20 
Command Batching, 8-25 
Data, 4-3, 6-6, 6-7, 6-14 
Dump, 6-12, 6-14, 6-33 
Image, 6-3, 6-33 
Image Alphanumeric, 6-10 
Image Binary, 6-10 
IOPS, 6-3 
IOPS Binary, 6-9 
Page, 3-9, 8-20, 9-29 
VT15 Display, 8-17, 8-18 
Modification procedures, 7-10 
Monitor, 1-1 
commands, 5-1 
destruction, 7-9 
errors, 3-10, 10-5 
functions, 3-1 
loading and starting, 7-8 
Monitor Identification Code (MIC), 
2-6, 3-6, 7-1, 8-9, H-l 
Monitor/User interaction, 3-3 


•.MTAPE macro, 6-21 
MTDUMP, 2-9 

.DAT slot assignments, 9-10 


Non-directoried access, 4-6 
Non-parity IOPS ASCII, 6-8 
Nonresident Monitor, 3-1 


Object code, 3-7 
Object program, relocatable, 2-1 
Object Time System (OTS), 2-2 

Operating errors, DOSSAV, 7-7,7-8 
Operating procedures, 10-1 
saving/restoring, 7-3 
Overflow of buffer, 6-6, 6-13 
.OVRLA macro, 5-6 


Packing routine, IOPS ASCII, B-2 
Page Mode operation, 3-9 
PAGE ON/OFF command, 8-20 
Paging Mode VT15, 8-18, 9-29 
Paper tape 
files, 3-5 
I/O, 6-12 

Paper Tape Punch handlers, 9-15 
Paper Tape Reader handlers, 9-16 
Parity, 6-8, 6-9 

PATCH .DAT slot assignments, 9-7 
PATCH utility program, 2-7, 

$PAUSE command, 8-27 
PDP-8 to PDP-9 Translator (89TRAN), 
2-13 

PDP-8 to PDP-15 Translator (8TRAN) , 
2-13 

Peripheral Interchange Program 
(PIP), 2-11 

.DAT slot assignments, 9-7 
Priority Interrupt (PI), 3-4 

skip chain order, 8-3 
Programming example, I/O, 6-33 to 
6-43 

Programs, 2-1 
loading, 3-9 

Program start, restart, continue 
commands, 8-2, 8-23, 8-25 
PROTECT command, 8-9 
Protection codes, 3-7, 4-9, 8-9 
default code, 3-7 
PUT command, 8-15 
.PUT macro. 5-3 


QDUMP command, 8-15 
Question/answer sequence, SGEN, 2-5 

.RAND macro, 6-21 
Random access, 4-4 
Random-sequential access, 4-4 
.READ macro, 6-3, 6-22 
Real-time clock, 1-8 
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Reassignment of .DAT slots, 8-12 
Records 

definition of, 4-2 
logical, 6-3 

Relocatable binary, 3-7, 3-8 
Relocatable object program, 2-1 
Relocatable output, 3-7, 3-8 
.RENAM macro, 6-23 

REQUEST command, 8-8,8-10,8-11,8-28 

Resident Monitor, 3-1 

Restart 

bootstrap, 7-9 
DOSSAV, 7-8 

system program, 8-23 
Restore core image, 8-16 
Restoring procedures, 7-3 
Retrieval Information Block (RIB),4-11 
RF15 DECdisk, 1-6 see also Disk 
RP02 Disk Pack, 1-6 see also Disk Pack 
.RTRAN macro, 6-3,6-23,6-33 
RUBOUT, 8-2 


System (cont.) 

initialization, 7-1 
loader, 3-1 

loader errors, 3-10, E-l 
macros, expansions, 5-2 to 5-7 
macros, summary, 5-1 
modification procedures, 7-10 
program errors, 10-5 
program loading commands, 8-23, 
8-24 

programs, 2-1 
software, 1-9, 7-1 
startup, 7-2 

System Communication Table (.SCOM) 
3-2, 6-16 

System Generator (SGEN), 2-6, 7-13 


SAT (Storage Allocation Table), H-l 

Saving software, 7-3 

Science library, 2-2 

SCOM command, 8-3 

SCOM (System Communication Table), 

3-2, 6-16 

Scroll mode, VT15, 8-18 

.SEEK macro, 6-24, 6-33 
7-bit ASCII characters, 6-7, 6-8 

Sequential access, 4-4, 4-11 
Sequential files, 3-5 
processing, 6-3 
structure, 4-5 
SGEN, 2-4, 2-5, 7-10 

.DAT slot assignments, 9-7 
Sixbit file representation, 5-2 
ASCII character packing, 5-2 
Software, 7-1 
Software, system, 1-6, 1-8 
how supplied, 1-10 
Source Compare Program (SRCCOM), 2-11 
.DAT slot assignments, 9-9 
Spaces, 5-1, 5-2 
SPOOL program 

.DAT slot assignments, 9-11 
ERROR messages, 1-1 
Starting 

Monitor, 7-8 
system, 7-1, 7-2 
Storage device, 6-12 
non-mass, 6-8, 6-33 
Subprograms, library, 2-8 
Symbolic names, 6-35 
Symbols, global, 2-3, 3-8, 3-9 
Syntax, I/O macro, 6-29 
SYSBLK System Block, H-l 
.SYSBLD see System Loader 
System 

concepts, 3-1 
default parameters, 8-3 
device, 1-8 
features, 1-2 
hardware, 1-3 
information, commands to 

request, 8-3 X- 


Tab, 5-1 r 

Tailoring system, 7-10 
Teleprinter, 3-3 
console, 8-1 

Teleprinter device handler, 8-20, 
9-12 to 9-14 

Teleprinter non-printing function 
characters, 9-12 
Terminating condition, logical 
record, 6-4, C-l 
Termination of program, uncondi¬ 
tional, 8-22 
Terminator 

i/o, 6-31 t 
keyboard command, 8-2 
of logical record, 6-12, 6-13 
Terms and acronyms, H-l 
Text Editor programs, 2-10 
Text output, switching between 

teleprinter and VT04 screen, 8-19 
TIME command, 8-21 
.TIMER macro, 5-7 
TIMEST command, 8-22 
Track count, 9-23 
iTRAN macro, 6-3, 6-25 

8TRAN (PDP-8 to PDP-15 Translator 
program), 2-12 

.DAT slot assignments, 9-10 
Transfers to directoried devices, 
6-31 

33TTY ON/OFF command, 8-20 


UFD see User File Directory 
.UFDT see User File Directory 
Table 

UIC see User Identification Code 
Unichannel 15 System ERROR 
MESSAGES, J-l 

Unpacking routines, IOPS ASCII, 

B-l 

Up arrow ( ) usage, 8-19 

UPDATE (Library UPDATE program),2-1 
.DAT slot assignments, 9-8 



User File Directory (UFD), 3-6, 4-8, 
H—1 

User File Directory Table, 3-6, 4-9, 
H-l 

User Identification Code, 3-6, 4-8, 
H-l 

.USER macro, 6-26 
Using I/O macros, 6-29 


Vertical form control characters, 9-26 
VP15A Graphics software, 2-13 
VP15A Storage Tube Display, 9-30 
VTJ34 Display Console, 1-5, 8-19 
VT15 Display 

buffer size, 8-19 
clearing display screen, 8-18 
command default settings, 8-19 
commands, 8-17 to 8-19 
editing, 8-18 
modes, 8-17 

text switching between teleprinter 
and VT15, 8-19 

VT15 Graphics software, 2-11 
VT ON/OFF command, 8-18 


.WAIT macro, 6-27 
.WAITR macro, 6-27 
Word count, 6-4, 6-6, 6-12 
for .READ/.WRITE macros, 6-14 
Word Pair Count, 6-4, 6-13 
Words, definition of, 4-2 
.WRITE command (macro), 6-3, 6-28 


X4K ON/OFF command, 8-14 


X-6 





HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi¬ 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 
P. 0. Box F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital's software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 


Reading, England 
Paris, France 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 


Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard, Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 

Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 


DECUS, Digital Equipment Computer Users Society, maintains a user ex¬ 
change center for user-written programs and technical application in¬ 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS Europe 

Digital Equipment Corporation International 
P.O. Box 340 
1211 Geneva 26 
Switzerland 






DOS-15 User’s Manual 
DEC-15-0DUMA-B-D 


READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page). 


Did you find errors in this manual? If so, specify by page. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Non-programmer interested in computer concepts and capabilitie 

Name _____ Date__ 

Organization ______ 

Street___ 

City-___State_Zip Code_ 

or 

Country 

If you do not require a written reply, please check here. □ 





Fold Here 






Do Not Tear - Fold Here and Staple 




BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 


Postage will be paid by: 
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Software Communications 
P. 0. Box F 

Maynard, Massachusetts 01754 
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